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terminal worms 

hangman hangman 

worm 

game hunt 

battlestar 

adventure 

error messages error 

messages a. error 

rain 

arguments apply 

yes 

bibliography, indxbib, lookbib 

cat 

chgrp 

chmod 

information chfn, chsh, passwd 

checknr 

compress, uncompress, zcat 

tip, cu 

units 

English number 

dd 

bed 

cp 

tcopy 

a.tags 

database addbib 

whatis 

contains a unit a.which 

and create a default a.vadsrc 

snake, snscore 

on the target board cross a.run 

graph 

input soelim 

crypt 

and history mechanism for a.view 

time at 

versa expand, un expand 

robots 

previewing colcrt 

col 

references in documents refer 

find 

look 

keywords; print out the man 

spell, spellin, spellout 

a.pr 

troff tbl 

subsystem sees 

tty 

head 

source indent 

and teletypes last 

a.help 

spline 

a.ls 

Is 

options a. info 

lookup apropos- 

manual for program whereis 

regenerate groups make,makerules 

a.mklib 

In 

monop 

iron men sail 

od 

4014 tk 

language awk 

mesg 

ptx 

tc 
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fish 

mille 

boggle 

a.ld 

fortune 

date 

pr 

banner 

pagesize 

to be run atq 

thesaurus for diction, explain 

line numbers a.list 

arithmetic 

ratfor 

dependency order a, make 

a.cleanlib 

leave leave 

colrm 

a.rmlib 

printer spooling queue Iprm 

atrm 

eqn constructs deroff 

information a.rm 

directories rm, rmdir 

search list a.pathxs 

uniq 

rev 

roffbib 

xsend, xget, enroll 

stty 

groups 

reverse order lastcomm 

fmt 

sortbib 

sort 

a.db 

file into individual fsplit 

ipq 

su, ssu 

du 

a.du 

talk 

extreme prejudice kill 

quiz 

nroff 

troff^ nroff 

cribbage 

backgammon 

zork 

wump 

canfield canfield, cfscores 

tsort 

tr 

trek 

eqn, neqn, checkeq 

file touch 

from 

doing w 

window 

wall 

write 

tk : paginator for the Tektronix 

number : convert 

iqjille : play mille 

indent : indent and format 

and history mechanism for 

colcrt : filter nroff output for 

hangman hangman : 

: convert Arabic numerals to 

ratfor : rational 

fsplit : split a multi-routine 

fish : play 

worm : 

sees : front end for the 

tk : paginator for the 

a.info : list or change 



play "Go fish" ...,,. fish(6) 

play mille Bournes , mille(6) 

play the game of boggle ,...«..,...... boggle(6) 

prelinker „ . , . ...,,. a,ld(l) 

print a random, hopefully ............. fortune(6) 

print and set the date .,......, date(l) 

print file ,,,.,.. pr(l) 

print large banner on printer ..,.,».. ^ . . banner(6) 

print system page size .»,.,,., pagesize(l) 

print the queue of jobs waiting ,...«...,.» atq(l) 

print wordy sentences; diction(l) 

produce program listing with . * ^ ajist(l) 

provide drill in number facts arithmetic(6) 

rational Fortran dialect ....,.,, ratfor(l) 

recompile source files in , . , . , » , a,make(l) 

reinitialize library directory ,,..,.,«.,.. a.cleanlib(l) 

remind you when you have to ... , « leave(l) 

remove columns from a file .,,.,» .«o., « colrm(l) 

remove compilation library ..,.,. a.rmlib (1) 

remove jobs from the line «...,., Iprm(l) 

remove jobs spooled by at «..,.,.« atrm(l) 

remove nroff, troff, tbl and , deroff(l) 

remove source unit and library .... ^ . ...» . a,rm(l) 

remove (unlink) files or ...,,.. rm(l) 

report or change VADS library a.path(l) 

report repeated lines in a file uniq(l) 

reverse lines of a file . rev(l) 

run off bibliographic database roffbib(l) 

secret mail , send(l) 

set terminal options stty(l) 

show group memberships , , . , . groups(l) 

show last commands executed in ,»,.•.,.., lastcomm(l) 

simple text formatter .......*...,»,. fmt(l) 

sort bibliographic database ..;... ^ sortbib(l) 

sort or merge files ....,.....,..,,, sort(l) 

source level debugger ................ a.db(l) 

split a multi-routine Fortran . , . . , , fsplit(l) 

spool queue examination program Ipq(l) 

substitute user id temporarily su(l) 

summarize disk usage . du(l) 

summarize library disk usage ...;.... ^ ... . a.du(l) 

talk to another user ,......, talk(l) 

terminate a process with ........ ^ ... . kill(l) 

test your knowledge quiz(6) 

text formatting , . . . , , . nroff(l) 

text fQrmatting and typesetting ....... ^ .. . troff(l) 

the card game cribbage cribbage(6) 

the game .....,..,..,...,,.., backgammon(6) 

the game of dungeon zork(6) 

the game of hunt-the-wumpus ....,..,.,.. wump(6) 

the solitaire card game , , canfield(6) 

topological sort » * > tsort(l) 

translate characters .... ^ ....... ^ .. , tr(l) 

trekkie game , trek(6) 

typeset mathematics ....,...,,.,,.. eqn(l) 

update date last modified of a . ,.,.,.... . touch(l) 

who is my mail from? ^ , from(l) 

who is on and what they are w(l) 

window environment ............... window(l) 

write to all users ...,,,.,.... wall(l) 

write to another user write(X) 

4014 tk(l) 

Arabic numerals to English number(6) 

Bournes mille(6) 

C program source . ^ , , . indent(l) 

C shell command abbreviations ........... a.view(l) 

CRT previewing . colcrt(l) 

Computer version of the game , . hangman(6) 

English number number(6) 

Fortran dialect ratfor(l) 

Fortran file into individual fsplit(l) 

"Gofish" ..,.,.. . , fish(6) 

Play the growing worm game ...,...,,... worm(6) 

sees subsystem ...;... , . . sccs(l) 

Tektronix 4014 , . . . tk(l) 

VADS library options a.info(l) 
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a.pathxs : report or change 

a.vadsrc : display available 

a.view : establish command 

directory 

a random, hopefully interesting, 

bibliographic database 
usage 

battlestar : a tropical 

error messages 

yes : be repetitively 

library options 

with line numbers 

in dependency order 

error messages error : 

messages a.error : 

terminal v^^orms : 

rain : 

bed : convert to 

library search list 

of arguments 

arguments apply : 

keyword lookup 

: apply a command to a set of 

number facts 

libr2iry information 

library 

program on the target board 

od : octal, decimal, hex, 

waiting to be run 

versions and create a default 

create a a.vadsrc : display 

abbreviations and history 

library contains a unit 

processing language 



banner 



prmter 

print large 

game 



addbib : create or extend 

roffbib : run off 

sortbib : sort 

find references in a 

a : build inverted index for a 

whereis : locate source, 

execute a program on the target 

boggle : play the game of 

bibliography, indxbib, lookbib : 

: the solitaire card game 

solitaire card game canfield 

cfscores : the solitaire 

cribbage : the 

cat : 

game canfield canfield, 

a.info : list or 

a.pathxs : report or 

chgrp : 

chmod : 

chfn, chsh, passwd : 

tr : translate 

snake, snscore : display 

checknr : 

eqn, neqn, 

password file information 



VADS library search list a.path(l) 

VADS versions and create a a.vadsrc(l) 

abbreviations and history . a.view(l) 

a.cleanlib : reinitialize library a.cleanlib(l) 

adage fortune : print fortune(6) 

a.db : source level debugger ............ a.db(l) 

addbib : create or extend raddbib(l) 

a.du : summarize library disk ....,, a.du(l) 

adventure : an exploration game adventure(6) 

adventure game battlestar(6) 

a.error : analyze and disperse , . a.error(l) 

affirmative y6s(l) 

a.help : interactive help utility a,help(l) 

a.info : list or change VADS a.info(l) 

a.ld : prelinker « a.ld(l) 

a.list : produce program listing a.list(l) 

a.ls : list compiled programs a.ls(l) 

a.make : recompile source files a.make(l) 

a.mklib : make library directory a.mklib(l) 

analyze and disperse compiler error(l) 

analyze and disperse error a.error(l) 

animate worms on a display , worms(6) 

animated raindrops display • rain(6) 

antique media . bcd(6) 

a.pathxs : report or change VADS a.path(l) 

apply : apply a command to a set .......... apply(l) 

apply a command to a set of .......... ^ . apply(l) 

a.pr : format source code a.pr(l) 

apropos : locate commands by apropos(l) 

arguments apply apply(l) 

arithmetic : provide drill in , arithmetic(6) 

a.rm : remove source unit and a,rm(l) 

a.rmlib : remove compilation a.rmlib(l) 

a.run : download and execute a a.run(l) 

ascii dump od(l) 

a.tags : create a tags file a.tags(l) 

atq : print the queue of jobs , a^(l) 

atrm : remove jobs spooled by at atrm(l) 

a.vadsrc : display available VADS a.vadsrc(l) 

available VADS versions and . . . . , a,vadsrc(l) 

a.view : establish command . , a.view(l) 

a. which : determine which project • • • a.which(l) 

awk : pattern scanning and ............* awk(l) 

backgammon : the game backgammon(6) 

banner : print large banner on banner (6) 

banner on printer banner(6) 

battlestar : a tropical adventure . battlestar(6) 

bed : convert to antique media bcd(6) 

bibliographic database raddbib(l) 

bibliographic database ................. roffbib(l) 

bibliographic database sortbib(l) 

bibliography for a bibliography, lookbib(l) 

bibliography, find references in lookbib(l) 

binary, and or manual for program . , whereis(l) 

board cross compilers and a.run(l) 

boggle boggle(6) 

boggle : play the game of boggle boggle(6) 

build inverted index for a . . , k . , lookbib(l) 

canfield canfield, cfscores canfield(6) 

canfield, cfscores : the . ^ . . canfield(6) 

card game canfield canfield, canfield(6) 

card game cribbage cribbage(6) 

cat : catenate and print . cat(l) 

catenate and print , , cat(l) 

cfscores : the solitaire card canfield(6) 

change VADS library options a.info(l) 

change VADS library search list a,path(l) 

change group chgrp(l) 

change mode chmod(l) 

change password file information passwd(l) 

characters tr(l) 

chase game snake(6) 

check nroff troff files . checknr(l) 

checkeq : typeset mathematics . eqn(l) 

checknr : check nroff troff files , . . checknr(l) 

chfn, chsh, passwd : change passwd(l) 
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file information chfn, 
a.pr : format source 

CRT previewing 

file 

colrm : remove 

mechanism for a.view : establish 

whatis : describe what a 

apply : apply a 

at : execute 

apropos : locate 

order lastcomm : show last 

a.rmlib : remove 

a.ls : list 

error : analyze and disperse 

program on the target board cross 

compress, uncompress, zcat : 

compress and expand data 

tip, cu : 

remove nroff, troff, tbl and eqn 

: determine which project library 

Is : list 

units : 

English number : 

dd : 

bed : 

cp : 

dd : convert and 

tcopy : 

available VADS versions and 

a.tags : 

database addbib : 

cribbage : the card game 

a program on the target board 

tip, 

spline : interpolate smooth 

zcat : compress and expand 

: create or extend bibliographic 

roffbib : run off bibliographic 

sortbib : sort bibliographic 

date : print and set the 

touch : update 

a.db : source level 

od : octal, 

crypt : encode 

VADS versions and create a 

mesg : permit or 

: recompile source files in 

and eqn constructs 

whatis : 

contains a unit a. which : 

ratfor : rational Fortran 

wordy sentences; thesaurus for 

sentences; thesaurus for diction 

rmdir : remove (unlink) files or 

a.cleanlib : reinitialize library. 

a.mklib : make library 

Is : list contents of 

a.du : summarize library 

du : summarize 

error : analyze and 

a. error : analyze and 

rain : animated raindrops 

and create a default a.vadsrc : 

snake, snscore : 

worms : animate worms on a 

insert literature references in 

w : who is on and what they are 

the target board cross a.run : 



chgrp : change group ................ chgrp(l) 

chmod : change mode ,«,,.»«..,...,. chmod(l) 

chsh, passwd : change password ....»,.... passwd(l) 

code a.pr(l) 

col : filter reverse line feeds . col(l) 

colcrt : filter nroff output for , colcrt(l) 

colrm : remove columns from a ....,« colrm(l) 

columns from a file ,..*..,..,.»..,, colrm(l) 

command abbreviations and history , a.view(l) 

command is .,..,.„. , whatis(l) 

command to a set of arguments apply(l) 

commands at a later time . . . , at(l) 

command? by keyword lookup , ap?-opos(l) 

commands executed in reverse ....»,..,.. lastcomm(l) 

compilation library • » . , a.rmlib (1) 

compiled programs ................ a.ls(l) 

compiler error messages .............. error(l) 

compilers download and execute a .,.....,. a.run(l) 

compress and expand data compress(l) 

compress, uncompress, zcat : » . . , . compress(l) 

connect to a remote system tip(lc) 

constructs deroff : „ deroff(l) 

contains a unit a.which . ^ . « . . . a.which(l) 

contents of directory » . » « ^ , , , , ^ is(l) 

conversion program units(l) 

convert Arabic numerals to . number(6) 

convert and copy a file '..,..,,,.«..., . dd(l) 

convert to antique media . , bcd(6) 

copy cp(l) 

copy a file dd(l) 

copy a mag tape tcopy(l) 

cp : copy .,.,... cp(l) 

create a default library display ......«.,., a.vadsrc(l) 

create a tags file . . , .....,.,.. a.tags(l) 

create or extend bibliographic , , . . raddbib(l) 

cribbage ..................... cribbage(6) 

cribbage : the card game cribbage ....»,..., cribbage(6) 

cross compilers and execute . a.run(l) 

crypt : encode decode .....,....«.«.. crypt(l) 

cu : connect to a remote system tip(lc) 

curve ...,., spline(lg) 

data compress, uncompress, compress(l) 

database addbib . . , raddbib(l) 

database roffbib(l) 

database ,...,.....«.,.. sortbib(l) 

date , date(l) 

date : print and set the date . date(l) 

date last modified of a file , . , . . touch(l) 

dd ; convert and copy a file , » dd(l) 

debugger « , . . . a.db(l) 

decimal, hex, ascii dump ,..,.,. od(l) 

decode crypt(l) 

default library available ..,..,.,..,... a.vadsrc(l) 

deny messages . » . . p mesg(l) 

dependency order a,make a.make(l) 

deroff : remove nroff, troff, tbl , . . , deroff(l) 

describe what a command is whatis(l) 

determine which project library ........... a,which(l) 

dialect .....,, ...,..., ratfor(l) 

diction diction, explain : print . , . ^ diction(l) 

diction, explain : print wordy diction(l) 

directories rm, rm(l) 

directory , a.cleanlib(l) 

directory ...... a.mklib(l) 

directory ls(l) 

disk usage .,.,.. a.du(l) 

disk usage ,..»..,,.,......,.„,, du(l) 

disperse compiler error messages . . . . « error(l) 

disperse error messages ,«.,.... a.error(l) 

display . rain(6) 

display available VADS versions « . . a.vadsrc(l) 

display chase game . , ....•.,,. snake(6) 

display terminal » . . . . worms(6) 

documents refer : find and refer(l) 

doing .....,..., , . . . w(l) 

download and execute a program on a.run(l) 
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graph : 
arithmetic : provide 

od : octal, decimal, hex, ascii 

zork : the game of 

input soelim : 

crypt : 

sees : front 

xsend, xget, 

window : window 

: remove nroff, troff, tbl and 

mathematics 

compiler error messages 

a.error : analyze and disperse 

: analyze and disperse compiler 

speliin, spellout : find spelling 

and history mechanism a.view : 

Ipq : spool queue 

board cross a.run : download and 

at : 

lastcomm : show last commands 

uncompress, zcat : compress and 

versa expand, un expand : 

spaces, and vice versa 

thesaurus for diction diction, 

adventure : an 

addbib : create or 

kill : terminate a process with 

: provide drill in number 

col : filter reverse line 

head : give first 

robots : 

a.tags : create a tags 

colrm : remove columns from a 

dd : convert and copy a 

pr : print 

rev : reverse lines of a 

: update date last modified of a 

uniq : report repeated lines in a 

chsh, passwd : change password 

: split a multi-routine Fortran 

checknr : check nroff troff 

find : find 

Fortran file into individual 

sort : sort or merge 

a.make : recompile source 

rm, rmdir : remove (unlink) 

previewing colcrt : 

col : 

references in documents refer : 

find : 

look : 

keywords; print out the man : 

index for a bibliography, 

spell, speliin, spellout : 

fish : play "Go 



indent : indent and 

a.pr : 

tbl: 

fmt : simple text 

nroff : text 

troff, nroff : text 

hopefully interesting, adage 

from : who is my mail 

sees : 

Fortran file into individual 

adventure : an exploration 

backgammon : the 

battlestar : a tropical adventure 

: a multi-player multi-terminal 

monop : monopoly 

snake, snscore : display chase 

trek : trekkie 



draw a graph , graph(lg) 

drill in number facts arithmetic(6) 

du : summarize disk usage du(l) 

dump od(l) 

dungeon zork(6) 

eliminate .so's from nroff soelim(l) 

encode decode crypt(l) 

end for the SCCS subsystem sccs(l) 

enroll : secret mail send(l) 

environment window(l) 

eqn constructs deroff . deroff(l) 

eqn, neqn, checkeq : typeset eqn(l) 

error : analyze and disperse error(l) 

error messages a.error(l) 

error messages error p . . . * error(l) 

errors spell, " spell(l) 

establish command abbreviations a.view(l) 

examination program . . . . , Ipq(l) 

execute a program on the target a.run(l) 

execute commands at a later time at(l) 

executed in reverse order lastcomm(l) 

expand data compress, compress(l) 

expand tabs to spaces, and vice . expand(l) 

expand, unexpand : expand tabs to expand(l) 

explain : print wordy sentences; diction(l) 

exploration game , adventure(6) 

extend bibliographic database raddbib(l) 

extreme prejudice kill(l) 

facts arithmetic arithmetic(6) 

feeds col(l) 

few lines head(l) 

fight off villainous robots . robots(6) 

file a.tags(l) 

file colrm(l) 

file dd(l) 

file . pr(l) 

file rev(l) 

file touch touch(l) 

file uniq(l) 

file information chfn, passwd(l) 

file into individual files fsplit(l) 

files checknr(l) 

files find(l) 

files : split a multi-routine fsplit(l) 

files sort(l) 

files in dependency order .............. a.make(l) 

files or directories , . . . , rm(l) 

filter nroff output for CRT colcrt(l) 

filter reverse line feeds col(l) 

find : find files ; . , . find(l) 

find and insert literature refer(l) 

find files find(l) 

find lines in a sorted list look(l) 

find manual information by man(l) 

find references in a bibliography lookbib(l) 

find spelling errors spell(l) 

fish" fish(6) 

fish : play "Go fish" . fish(6) 

fmt : simple text formatter , fmt(l) 

format C program source indent(l) 

format source code a.pr(l) 

format tables for nroff or troff tbl(l) 

formatter fmt(l) 

formatting nroff(l) 

formatting and typesetting troff (1) 

fortune : print a random, fortune(6) 

from? from(l) 

front end for the SCCS subsystem sccs(l) 

fsplit : split a multj-routine , fsplit(l) 

game adventure(6) 

game backgammon(6) 

game battlestar(6) 

game hunt hunt(6) 

game monop(6) 

game snake(6) 

game trek(6) 
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worm : Play the growing worm 

cfscores : the solitaire card 

cribbage : the card 

hangman : Computer version of the 

boggle : play the 

zork : the 

wump : the 

head : 

graph : draw a 

chgrp : change 
groups : show 

maintain, update, and regenerate 

worm : Play the 

: Computer version of the game 

game hangman 

a. help : interactive 

od : octal, decimal, 

command abbreviations and 

fortune : print a random, 

multi-terminal game 

wump : the game of 

su, ssu : substitute user 

program source 

source indent : 

ptx : permuted 

indxbib, lookbib : build inverted 

teletypes last : 

a multi-routine Fortran file into 

index for a bibliography, find 

: remove source unit and library 

passwd ' change password file 

out the manual man : find manual 

: eliminate .so's from nroff 

documents refer ; find and 

a.help : 

: print a random, hopefully 

spline : 

indxbib, lookbib : build 

: multi-user wooden ships and 

spooling queue Iprm : remove 

atrm : remove 

atq : print the queue of 

apropos : locate commands by 

man : find manual information by 

extreme prejudice 

quiz : test your 

: pattern scanning and proce$sing 

banner : print 

executed in reverse order 

at : execute commands at a 

: remind you when you have to 

to leave 

a.db : source 

a.rmlib : remove compilation 

versions and create a default 

a.which : determine which project 

a.cleanlib : reinitialize 

a,mklib : make 

a.du : summarize 

a.rm : remove source unit and 

a. info : list or change VADS 

a.pathxs : report or change VADS 

col : filter reverse 

: produce program listing with 

Iprm : remove jobs from the 

head : give first few 

uniq : report repeated 

look : find 

rev : reverse 

In : make 

or change VADS library search 

look : find lines in a sorted 

a.ls : 



game ..,,.., 

game canfield canfield, .... 
game cribbage ....... o . 

game hangman 

game of boggle 

game of dungeon 

game of hunt-the-'Wumpus . . . 
give first few lines ....... 

graph 

graph : draw a graph ...... 

group 

group memberships 

groups : show group memberships 
groups of programs : ..... 

growing worm game . . . . . . 

hangman hangman ...... 

hangman : Computer version of the 
head : give first few lines .... 

help utility 

hex, ascii dump , , 

history mechanism for C shell . . 
hopefully interesting, adage . , . 
hunt : a multi-player ...... 

hunt-the-wumpus ..•..,. 

id temporarily . 

indent : indent and format C . . 
indent and format C program . . 
index ............. 

index for a bibliography, find . . 
indicate last logins of users and 
individual files fsplit : split . . . 
indxbib, lookbib : build inverted 
information a.rm . . . . . . . 

information chfn, chsh, .... 

information by keywords; print , 

input soelim 

insert literature references in . . 
interactive help utility . . ... 
interesting, adage fortune ... 
interpolate smooth curve .... 
inverted index for a ...... 

iron men sail 

jobs from the line printer .... 

jobs spooled by at 

jobs waiting to be run * . , . « 
keyword lookup .....,,. 
keywords; print out the manual , 
kill : terminate a process with . . 

knowledge , . . , 

language awk , . 

large banner on printer . . , • . 
lastcomjn ; show last commands 

later time 

leave leave ..-»...... 

leave : remind you when you have 
level debugger ......... 

library 

library : display available VADS 

library contains a unit 

library directory ........ 

library directory ...,..,. 

library disk usage « 

library information ,.,.... 

library options 

library search list ....... 

line feeds . . , 

line numbers a.list ....... 

line printer spooling queue * . . 

lines , 

lines in a file ..«.....,.: 

lines in a sorted list ....... 

lines of a file .......... 

links ...... ^ ...... , 

list a.pathxs : report . . . . . , , 

list ,......,., 

list compiled programs ....... 



worm(6) 

canfield(6) 

cribbage(6) 

hangman(6) 

boggle(6) 

zork(6) 

wump(6) 

head(l) 

graph(lg) 

graph(lg) 

chgrp(l) 

groups(l) 

groups(l) 

make(l) 

worm (6) 

hangman (6) 

hangman (6) 

head(l) 

a.help(l) 

od(l) 

a.view(l) 

fortune(6) 

hunt(6) 

wump(6) 

su(l) 

indent(l) 

indent(l) 

ptx(l) 

lookbib(l) 

last(l) 

fsplit(l) 

lookbib(l) 

a.rm(l) 

passwd(l) 

man(l) 

soelim(l) 

refer(l) 

a.help(l) 

fortune(6) 

spline(lg) 

lookbib(l) 

sail(6) 

Iprm(l) 

atrm(l) 

atq(l) 

apropos(l) 

man(l) 

kill(l) 

quiz(6) 

awk(l) 

banner(6) 

lastcomm(l) 

at(l) 

leave(l) 

leave(l) 

a.db(l) 

a.rmlib (1) 

a.vadsrc(l) 

a.which(l) 

a.cleanlib(l) 

a.mklib(l) 

a.du(l) 

a.rm(l) 

a.info(l) 

a.path(l) 

col(l) 

a.list(l) 

Iprm(l) 

head(l) 

uniq(l) 

look(l) 

rev(l) 

HI) 
a.path(l) 
look(l) 
a.ls(l) 
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Is : 

options 9..info : 

a. list : produce program 

refer : find and insert 

apropos : 

manual for program whereis : 

last ; indicate last 

list 

for a bibliography, indxbib, 

: locate comra^ds by keyword 

program 

printer spooling queue 

tcopy : copy a 

xsend, xget, enroll ; secret 

from : who is my 

groups of make,makerules : 

update, and regenerate groups of 

by keywords; print out the 

: locate source, binary, and or 

print out the manual man : find 

eqn, neqn, checkeq : typeset 

command abbreviations and history 

bed : convert to antique 

groups : show group 

sort : sort or 

: analyze and disperse error 

and disperse compiler error 

mesg : permit or deny 

mille : play 

chmod : change 

touch ; update date last 

monop : 

hunt : a 

individual fsplit : split a 

hunt : a multi-player 

men sail : 

tty : get terminal 

mathematics eqn, 

typesetting troff, 

soelim : eliminate .so's from 

tbl : format tables for 

colcrt : filter 

checknr : check 

constructs deroff : remove 

to English 

arithmetic : provide drill in 

produce program listing with line 

number : convert Arabic 

od: 

dump 

: list or change VADS library 

stty : set terminal 

source files in dependency 

last commands executed in reverse 

colcrt : filter nroff 

pagesize : print system 

tk: 

information chfn, chsh, 

chfn, chsh, passwd : change 

language awk : 

mesg : 

ptx : 

tc : 

fish : 

mille : 

boggle : 

terminate a process with extreme 
a.ld : 



list contents of directory ls(l) 

list or change VADS library a.info(l) 

listing with line numbers . . . . ^ ^ . . , a.list(l) 

literature references in refer(l) 

In : make links ln(l) 

locate commands by keyword lookup ..,....*; apropos(l) 

locate source, binary, and or , . . . . whereis(l) 

logins of users and teletypes last(l) 

look : find lines in a sorted look(l) 

lookbib : build inverted index lookbib(l) 

lookup apropos apropos(l) 

Ipq : spool queue examination Ipq(l) 

Iprm : remove jobs from the line Iprm(l) 

Is : list contents of directory ls(l) 

mag tape tcopy(l) 

mail r . . . . send(l) 

mail from? , from(l) 

maintain, update, and regenerate raake(l) 

make,makerules : maintain, make(l) 

manual : find manual information . p n . man(l) 

manual for program whereis ,...,. whereis(l) 

manual information by keywords; » . . . , man(l) 

mathematics . ^ ..... . eqn(l) 

mechanism for C shell establish a.view(l) 

media bcd(6) 

memberships groups(l) 

merge files sort(l) 

mesg : permit or deny messages mesg(l) 

messages a, error , • . . . a.error(l) 

messages error : analyze error(l) 

messages mesg(l) 

mille : play mille Bournes , . . .- miHe(6) 

mille Bournes miHe(6) 

mode • ' V • chmod(l) 

modified of a file touch(l) 

monop : monopoly game monop(6) 

monopoly game . . • monop(6) 

multi-player multi-terminal game hunt(6) 

multi-routine Fortran file into ^ fsplit(l) 

multi-terminal g£ime hunt(6) 

multi-user wooden ships and iron sail(6) 

name tty(l) 

neqn, checkeq : typeset ^^"(1) 

nroff : text formatting nroff(l) 

nroff : text formatting and troff(l) 

nroff input , soelim(l) 

nroff or troff tbl(l) 

nroff output for CRT previewing colcrt(l) 

nroff troff files checknr(l) 

nroff, troff, tbl and eqn deroff (1) 

number : convert Arabic numerals number(6) 

number facts arithmetic(6) 

numbers a.list : a.list(l) 

numerals to English number(6) 

octal, decimal, hex, ascii dump f od(l) 

od : octal, decimal, hex, ascii . od(l) 

options a.info ^ . . . a.info(l) 

options stty(l) 

order a.make : recompile , a.make(l) 

order lastcomm : show lastcomm(l) 

output for CRT previewing colcrt(l) 

page size pagesize(l) 

pagesize : print system page size . pagesize(l) 

paginator for the Tektronix 4014 tk(l) 

passwd : change password file passwd(l) 

password file information passwd(l) 

pattern scanning and processing awk(l) 

permit or deny messages mesg(l) 

permuted index ptx(l) 

photoypesetter simulator tc(l) 

play **Go fish" fish(6) 

play mille Bournes ................. mille(6) 

play the game of boggle boggle(6) 

pr : print file pr(l) 

prejudice kill : kill(l) 

prelinker a.ld(l) 
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: filter nroff output for CRT 

cat : catenate and 

interesting, adage fortune : 

date : 

pr : 

banner : 

manual information by keywords; 

pagesize : 

to be run atq : 

for diction diction, explain : 

banner : print large banner on 

Iprm : remove jobs from the line 

kill : terminate a 

awk ; pattern scanning and 

numbers a.list : 

Ipq : spool queue examination 

units : conversion 

source, binary, and or manual for 

aJist : produce 

a.run : download and execute a 

indent : indent and format C 

a.ls : list compiled 

update, and regenerate groups of 

a.which : determine which 

arithmetic : 

from the line printer spooling 

Ipq : spool 

atq : print the 



rain : animated 
adage fortune : print a 

ratfor : 

dependency order a.make : 

literature references in 

index for a bibliography, find 

: find and insert literature 

: maintain, update, and 

axleanlib : 

leave : 

tip, cu : connect to a 

colrm : 

a.rmlib : 

spooling queue Iprm : 

atrm : 

constructs deroff : 

information a.rm : 

directories rm, rmdir : 

uniq '. report 

yes : be 

search list a.pathxs : 

uniq : 

col : filter 

rev : 

show last commands executed in 

files or directories 

directories rm, 

robots : fight off villainous 

robots 

database 

the queue of jobs waiting to be 

roffbib : 

and iron men 

awk : pattern 

subsystem 

: report or change VADS library 

xsend, xget, enroll : 

diction, explain : print wordy 

apply : apply a command to a 

stty : 

date : print and 

and history mechanism for C 

sail : multi-user wooden 



previewing colcrt . , , » . . , « colcrt(l) 

print . , . cat(l) 

print a random, hopefnlly ^ . . « . . . fortune(6) 

print and set the date ............... date(l) 

print file pr(l) 

print large b dinner on printer banner(6) 

print out the manual man : find ........,, man(l) 

print system page size , ..».., pagesize(l) 

print the queue of jobs waiting atq(l) 

print wordy sentences; thesaurus diction(l) 

printer ..,.,,..... banner(6) 

printer spooling queue ............... Iprm(l) 

process with extreme prejudice ........... kill(l) 

processing language , . . awk(l) 

produce program listing with line .*..«,.... a.list(l) 

program Ipq(l) 

program ...,...,.. units(l) 

program whereis : locate whereis(l) 

program listing with line numbers ^ . . . a.Hst(l) 

program on the target board cross , . a.run(l) 

program source ...,.., indent(l) 

programs ...,.,.,...»>.,...... a.ls(l) 

programs : maintain, ,..,,.. make(l) 

project library contains a unit .,....,,.... a.which(l) 

provide drill in number facts arithmetic(6) 

ptx : permuted index ...« ........... . ptx(l) 

queue Iprm : remove jobs ............. Iprm(l) 

queue examination program Ipq(l) 

queue of jobs waiting to be run atq(l) 

quiz : test your knowledge quiz(6) 

rain : animated raindrops display . , . rain(6) 

raindrops display . rain(6) 

random, hopefully interesting, fortune(6) 

ratfor : rational Fortran dialect , . , . . ratfor(l) 

rational Fortran dialect ....,...,.,.... ratfor(l) 

recompile source files in a.make(l) 

refer : find and insert , refer(l) 

references in a bibliography ^ . . . • , lookbib(l) 

references in documents refer refer(l) 

regenerate groups of programs ........... make(l) 

reinitialize library directory , a.cleanlib(l) 

remind you when you have to leave ,.,.«.,., leave(l) 

remote system tip(lc) 

remove columns from a file . colrm(l) 

remove compilation library a,rmlib(l) 

remove jobs from the line printer Iprm(l) 

remove jobs spooled by at , , . . atrm(l) 

remove nroff, troff, tbl and eqn ........... deroff (1) 

remove source unit and library . . . , a.rm(l) 

remove (unlink) files or ...»......;.,. rm(l) 

repeated lines in a file , , uniq(l) 

repetitively affirmative . , ^ . , , . » . yes(l) 

report or change VADS library ........... a.path(l) 

report repeated lines in a file ,.,.*,...... uniq(l) 

rev ; reverse lines of a file . rev(l) 

reverse line feeds ...,.,., col(l) 

reverse lines of a file ......•.., rev(l) 

reverse order lastcomm lastcomm(l) 

rm, rmdir : remove (nnlink) ».,,., rm(l) 

rmdir : remove (unlink) files or rm(l) 

robots .,...,,....,,,.. robots(6) 

robots : fight off villainous , robots(6) 

roffbib : run off bibliographic , roffbib (1) 

run atq : print ..*.,..,,. atq(l) 

run off bibliographic database ..,..,.,.... roffbib (1) 

sail : multi-user wooden ships sail(6) 

scanning and processing language ...» awk(l) 

sees : front end for the 3 CCS ............ sccs(l) 

search list a.pathxs a.path(l) 

secret mail ,..,'.. ^ . , send(l) 

sentences; thesaurus for diction . diction(l) 

set of arguments . ^ . . . apply(l) 

set terminal options stty(l) 

set the date ,. ...,,., date(l) 

shell command abbreviations . . . . .... . . , . a.view(l) 

ships and iron men sail(6) 



C 



( 



( 



Page xiv 



February 1989 



MIPS Computer Systems, Inc. 



Permuted Index 



RISC/ OS Programmer's Reference 



Permuted Index 



groups : 

reverse order lastcomm : 

fmt : 

tc : photoypesetter 

pagesize : print system page 

spline : interpolate 

game 

snake, 

nroff input 

canfield, cf scores : the 

tsort : topological 

sortbib : 

sort : 

database 

look : find lines in a 

soelim : eliminate 

: indent and format C program 

program whereis : locate 

a.pr : format 

a.make : recompile 

a.db : 

information a.rm : remove 

expand, unexpand : expand tabs to 

spelling errors 

errors spell, 

spell, spellin, spellout : find 

spell, spellin, 

file into individual f split : 

Ipq : 

atrm : remove jobs 

remove jobs from the line printer 

temporarily su, ' 

temporarily 

su, ssu : 

sees : front end for the SCCS 

du: 

a.du : 

tip, cu : connect to a remote 

pagesize : print 

tbl : format 

expand, unexpand : expand 

a. tags : create a 

talk : 

tcopy : copy a mag 

and execute a program on the 

troff 

deroff : remove nroff, troff. 



indicate last logins of users and 

su, ssu : substitute user id 

: animate worms on a display 

tty : get 

stty : set 

prejudice kill : 

quiz : 

fmt : simple 

nroff : 

troff, nroff ; 

explain : print wordy sentences; 

system 

4014 

tsort : 

of a file 

tr : 

trek : 

tbl : format tables for nroff or 

checknr : check nroff 

and typesetting 

deroff : remove nroff, 



show group memberships groups(l) 

show last commands executed in . . . .• lastcomm(l) 

simple text formatter fmt(l) 

simulator tc(l) 

size ,...., pagesize(l) 

smooth curve . , o spline(lg) 

sn£ike, snscore : display chase snake(6) 

snscore : display chase game snake(6) 

soelim : eliminate .so's from soelim(l) 

solitaire card game canfield canfield(6) 

sort * tsort(l) 

sort : sort or merge files sort(l) 

sort bibliographic database ............. sortbib(l) 

sort or merge files sort(l) 

sortbib : sort bibliographic sortbib(l) 

sorted list . . * look(l) 

.so's from nroff input soelim(l) 

source indent indent(l) 

source, binary, and or manual for whereis(l) 

source code a.pr(l) 

source files in dependency order a.make(l) 

source level debugger a.db(l) 

source unit and library a.rm(l) 

spaces, and vice versa . . . , expand(l) 

spell, spellin, spellout : find spell(l) 

spellin, spellout : find spelling spell(l) 

spelling errors spell(l) 

spellout : find spelling errors spell(l) 

spline : interpolate smooth curve spline(lg) 

split a multi-routine Fortran fsplit(i) 

spool queue examination program ip<5(l) 

spooled by at ^ • . • atrm(l) 

spooling queue Iprm : Iprm(l) 

ssu : substitute user id su(l) 

stty : set terminal options stty(l) 

su, ssu : substitute user id . . . . « su(l) 

substitute user id temporarily su(l) 

subsystem sccs(l) 

summarize disk usage « <^u(l) 

summarize library disk usage a.du(l) 

system tip(lc) 

system page size pagesize(l) 

tables for nroff or troff tbl(l) 

tabs to spaces, and vice versa ............ expand(l) 

tags file a.tags(l) 

talk : talk to another user talk(l) 

talk to another user talk(l) 

tape . tcopy(l) 

target board cross compilers a,run(l) 

tbl : format tables for nroff or tbl(l) 

tbl and eqn constructs deroff(l) 

tc : photoypesetter simulator tc(l) 

tcopy ; copy a mag tape tcopy(l) 

teletypes last : last(l) 

temporarily su(l) 

terminal worms worms(6) 

terminal name tty(l) 

terminal options , stty(l) 

terminate a process with extreme kill(l) 

test your knowledge quiz(6) 

text formatter fmt(l) 

text formatting nroff(l) 

text formatting and typesetting troff(l) 

thesaurus for diction diction, . diction(l) 

tip, cu : connect to a remote tip(lc) 

tk : paginator for the Tektronix tk(l) 

topological sort tsort(l) 

touch : update date last modified touch(l) 

tr : translate characters * . . tr(l) 

translate characters , . ' tr(l) 

trek : trekkie g£ime . trek(6) 

trekkie game trek(6) 

troff . tbl(l) 

troff files checknr(l) 

troff, nroff : text formatting troff(l) 

troff, tbl and eqn constructs deroff(l) 
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battlestar : a 



eqn, neqn, checkeq : 

nroff : text formatting and 

expand data compress, 

and vice versa expand, 

file 

which project library contains a 

a.rm : remove source 

rm, rmdir : remove 

make,makerules ; maintain, 

file touch : 

a.du : summarize library disk 

du : summarize disk 

talk : talk to another 

write : write to another 

su, ssu : substitute 

wall : write to all 

last : indicate last logins of 

a.help : interactive help 

: expand tabs to spaces, and vice 

hangman : Computer 

a.vadsrc : display available VADS 

: expand tabs to spaces, and 

robots : fight off 

doing 

atq : print the queue of jobs 



and or manual for program 

window : 

sail : multi-user 

diction diction, explain : print 

worm : Play the growing 

display terminal 

worms : animate 

wall : 

write : 

hunt-the-wumpus 

xsend. 



compress, uncompress, 



tropical adventure game ....,,.......„ battlestar(6) 

tsort : topological sort .»,,,.....,.... tsort(l) 

tty : get terminal name ,.,«,..,«....,„ tty(l) 

typeset mathematics ...,...,,„,.,.,. eqn(l) 

typesetting troff, ................. troff(l) 

uncompress, zcat : compress and ....-..,,. compress(l) 

unexpand : expand tabs to spaces, , , . . expand(l) 

uniq : report repeated lines in a uniq(l) 

unit a.which : determine .,,..,.,,.,,., a.which(l) 

unit and library information ,,,,...,..,., a.rm(l) 

units : conversion program ..«,.».«,«.. . units(l) 

(unlink) files or directories ..,.,..,,.».. rm(l) 

update, and regenerate groups of , . , . , make(l) 

update date last modified of a ,..,....,,., touch(l) 

usage , ...,,, a.du(l) 

usage . • . . , , . . : . du(l) 

user ...,....«. talk(l) 

user .,»..,»,..,...,«,....„. write(l) 

user id temporarily ,...,, ,,.... su(l) 

users wall(l) 

users and teletypes , . . . last(l) 

utility «... a.help(l) 

versa expand, unexpand »..,...,,..«.. expand(l) 

version of the game hangman .... ,..o ... . hangman (6) 

versions and create a default a.vadsre(l) 

vice versa expand, unexpand expand(l) 

villainous robots robots(6) 

w : who is on and what they are w(l) 

waiting to be run , atq(l) 

wall : write to all users ^ .,,.... wall(l) 

whatis ; describe what a command .«..,..., whatis(l) 

whereis : locate source, binary, .,..,...,. ^ whereis(l) 

window ; window environment ........... window(l) 

window environment ................ window(l) 

wooden ships and iron men ..,.., , sail(6) 

wordy sentences; thesaurus for ........... diction(l) 

worm : Play the growing worm game . , . worm(6) 

worm game ...."..,....,.,...... worm(6) 

worms : animate worms on a ..,..,..,., worms(6) 

worms on a display terminal ..,,.....,.. worms(6) 

write : write to another user ,...,., write(l) 

write to all users wan(l) 

write to another user . , write(l) 

wump : the game of , . . , . , wump(6) 

xget, enroll : secret mail .............. send(l) 

xsend, xget, enroll : secret mail ........... send(l) 

yes : be repetitively affirmative ,.,... yes(l) 

zcat : compress and expand data ..,...,,,. compress(l) 

?ork : the game of dungeon ............. zork(6) 
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NAME 

a.cleanlib - reinitialize library directory 

SYNOPSIS 

a.cleanlib [options] [VADSJibrary] 

DESCRIPTION 

a.cleanlib preserves all non-compilation information contained in adaJib, including any addi- 
tional libraries contained in the library search Ust and any other directives found in ada.lib. 

The command will empty the files GVASjable, ada.lib, and gnrxMb of all separate compila- 
tion information and remove the contents of the directories Mnes, Jmports, ,nets, and 
.objects from the named library, or, if no library is specified, from the current library direc- 
tory. It v^ill also remove the file name Jib if present. 

If a.cleanlib cannot find every library component, it will abort without removing any informa- 
tion unless the ~f (force) option is given. 

The -F option is provided to allow a.cleanlib to clean a library having a reserved name {stan- 
dard, verdixUb, publicUb), 

OPTIONS 

-F (force name) allow the cleaning of a VADS library having a reserved name 

-f (force) clean the VADS library structure even if components are missing or if 

lock files are found. 

FILES 

GVAS^table address assignment file 

gnrxJib generic instantiation reference file 

adaJib library reference file 

Mnes line number reference files directory 

Jmports imported Ada units directory 

MCts Ada network control files directory 

.objects Ada object files directory 

DIAGNOSTICS 

An error is reported if any VADS component is missing, and no action is taken unless the -f 
option is used. 

SEE ALSO 

[VADS Reference] , a.mklib, a.rmlib. 



MIPS Computer Systems, Inc. February 16, 1989 Page 1 



A.DB ( 1 ) RISC/os Programmef s Reference A.DB (1 ) 



NAME 

a.db - source level debugger 

SYNOPSIS 

a.db [options] [executable__file] 

DESCRIPTION 

a.db is a symbolic debugger for Ada programs and for C programs compiled with the -go 
option for those using 4,2 BSD UNIX ^ ox the -g option on System V UNIX. Detailed 
descriptions of interactive a.db commands and runtime configuration file options are provided 
in the VADS Debugger Reference, which is also available on-line using a.h^lp or the debugger's 
internal help command. 

VADSJocation/bin/a,db is a wrapper program that executes the correct executable based upon 
directives visible in the ada.lib file. This permits multiple VADS compilers to exist on the 
same host. The -sh option prints the name of the actual executable file. 

OPTIONS 

-ifllejtame (input) read input from the specified file 

--p VADSJibrary 

(program) read program compilation information from the specified VADS 
library directory (rather than the current directory) 

-sh (show) display the name of the tool executable but do not execute it. 

~v (visual) invoke the screen-mode debugger directly. 

See also 

VADS Debugger Reference for a list of all debugger commands. 
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NAME 

a.du - summarize library disk usage 

SYNOPSIS 

a.du [options] [VADSJibrary] 

DESCRIPTION 

a.du lists size in bytes for all compiler-generated files in the specified VADS library. If no 
library is specified, the current directory is assumed. 

VADSJocation/bin/a,du is a wrapper program that executes the correct executable based upon 
directives visible in the adaJib file. This permits multiple VADS compilers to exist on the 
same host. The -sh option prints the name of the actual executable file. 

OPTIONS 

- a (address) sort the output by the GVAS address of each unit. 

- e (erroneous) include information for units with damaged or out-of-date net 

files. 



FILES 



- i 

- sh 

GVASjable 
.imports 
dines 
,nets 
.objects 



(file) sort output by the name of the file containing the unit. 
(GVAS) provide the base address of each unit in the GVAS. 
(imports) include information for imported units, 
(show) display the name of the tool executable but do not execute it. 

address assignment file 
imported Ada units directory 
line number reference files directory 
Ada network control files directory 
Ada object files directory 



MIPS Computer Systems, Inc. 



February 16, 1989 



Page 1 



A.ERROR ( 1 ) RISC/os Programmer's Reference A.ERROR ( 1 ) 



NAME 

a.error ~ analyze and disperse error messages 

SYNOPSIS 

a^error [options] [error_J51e] 

DESCRIPTION 

a^error is generally called from the ada command , but it can also be used separately, a.error 
analyzes and optionally disperses diagnostic error messages produced by the VADS compiler. 
It looks at the specified error file or the standard input, determines the source file and line 
number to which the error refers^ determines whether the error is to be ignored or not, and 
outputs the associated source line followed by the error line(s). 

a.error will also insert the error lines into the source file and invoke the vi(l) editor if the -v 
option is given. Error lines placed into files this way are of two types. The first gives the 
position of the error and the second identifies it. Multiple errors on a single line are 
referenced by sequential alphabetic characters, 

subtype T is range l..lf; 

- — ™— 'A ### 

. — _ .„^B ### 



-### A: syntax error: "identifier" inserted 
-### B: lexical error: deleted 

Because all error lines are flagged with ###, the vi editor command :g/###/d[ can be used to 
delete them. However, any source lines containing ### will ali?o be deleted; consequently, 
do not use ### in any source with which ^.error -v may be used. 

In the case of source files with multiple links, a.error creates a new copy of the file with only 
one link to it. 

OPTIONS 

- e editor (editor) Insert the error messages in 

the source file and invoke the specified editor. 

- 1 (listing) Produce a listing on the standard output. 

- N (no) do not display line numbers. 

--t number (tabs) Change tab default setting (8). 

(No space between -t and the following digit.) 

"- y (vi) Embed error messages in the source file and call the environment editor 

ERRORJBDrrOR. (If ERROR3DITOR is defined, the environment 
variable ERROR^PATTERN should also be defined. ERRORJPATTERN is 
an editor search command that locates the first occurrenice of *###^ in the 
error file.) If no editor is specified^ call vi. 

- W (warnings) Ignore warnings. 

DIAGNOSTICS 

a.error produces diagnostics indicating 'no errors' if -v is used and no errors were detected 
and 'no such file or directory' if invoked with an invalid file name, 

SEE ALSO 

[VADS Reference] ada. 
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NAME 

a.help - interactive help utility 

SYNOPSIS 

a.help [-options] [subject] 

DESCRIPTION 

On-line help is available for each of the VADS utilities and for debugger commands and 
concepts. Without a specified subject, a.help provides information on use of the help utility 
and prompts for additional subject names. Use q to exit from a.help. 

Without the -p option, a.help will use the paging program defined by the environment variable 
HELPER, requiring the full pathname with surrounding quotes for additional options. If 
HELPER is not defined, more is used. 

Reference manual entries for the compiler and tools only are available on-line by using the 
man command if the local system administrator has elected to install them. A list of topics 
can be pbtained with 

man ada 
and typing 

man VADS^command) 

will show the entry for a specific command. 

VADS Jocation\bin\a. help is a wrapper program that executes the correct executable based 
upon directives visible in the ada Jib. This permits multiple VADS compilers to exist on the 
same host. The -sh option prints the name of the actual executable file. 

OPTION 

- p pager (pager) Use pager as the paging program. The complete pathname must be 

given with surrounding quotes if additional options to the paging program are 
desired. 

- sh (show) display the name of the tool executable but do not execute it. 

ON-LINE HELP FROM THE DEBUGGER 

Access on-line help for the debugger as well as the compiler and tools during a debugging 
session by typing 

help [subject)] 
or 

:help[subject] while in screen mode. 

If the subject is omitted, a Ust of debugger commands is displayed. This overview can also 
be obtained by typing intro after a help prompt. Help with the help command can be 
obtained by typing help at a help prompt. 



FILES 



BVADSJocation/sup/helpJiles/* 
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NAME 1^ 

a.info - list or change VADS library options 

SYNOPSIS 

a.info [options] 

DESCRIPTION 

a.info is used to examine the INFO and LINK directives of the ada.lib. It can also be used to 
add or delete those directives from the ada Jib or to display or change the library search list. 

All directives have the format 

name:type:value: 

where name is the name of the directive, type can be the word LINK or INFO, and value is 
usually a file name. (More information on directives can be found in discussions of aJd.) 

Without options, a.info displays all directives in the current library. 

The »i option executes a.info in interactive mode. In this mode, all command line actions 
may be performed interactively, a.info prompts for and checks that the desired directive 
names and values are supported. 

For a complete list of directive names, BSee also 

Implementation Reference , Supported INFO and LINK Directive Names. 

For a discussion of WTTHn directives used with the preUnker, See also Users Guide, Program 
Generation Tools, aJd and [VADS Reference] , aJd. 

Regular expressions, shown in the options below, are formed by following the operating 
system documentation. 

SEE ALSO #" 

Operating system documentation, ed (1). ^ 

OPTIONS 

- a (all) Display all directives in each library on the library search list. 

- F (suffix) Display LINK directives with the suffix (L) and INFO directives with 

the suffix (I). 

- i (interactive) Operate in interactive mode. 

- p (path) Print the library search list. 

" s (short) Show just the INFO and LINK names. 

- V (verbose) Display maximum information. 

[+-']info name value 

Add, delete an INFO directive. 

[i-]lmk name value 

Add, delete an LINK directive. 

[+-]link WITHn va/w6 

Add, delete an LINK directive. 

+link yvim value 

Add a LINK directive having the next number: WTTHn 

[+'-]number VADSJibrary 

add, delete VADSJibrary in the number position to the library search list. 

-number removes VADS library in position number from the library search list 

"regular^expression'' ^ 

Print directives whose first name field matches regular jexpression, V 
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-value yegular^expression" 

Print directives whose last value field matches regular ^expression, 

FILES 

VADSJocation\sup\LEGAL JNFO A list of legal directives for this implementation. 
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NAME 

a, Id - prelinker 

SYNOPSIS 

aJd [options] uniCname [Id^options] 

DESCRIPTION 

hM collects the object files needed to make uniUwame a main program and calls the UNIX 
linker ld(l) to link together all Ada and other language objects required to produce an 
executable image in a.out. umt^name is the main program and must be a non-generic 
subprogram. If uniLname is a function, it must return a value of the type 
STANDARDJNTEGER. This integer result will be passed back to the UNIX shell as the 
status code of the execution. The utility uses the net files produced by the Ada compiler to 
check dependency information. ^Jd produces an exception mapping table and a unit 
elaboration table and passes this information to the linker. 

a.ld reads instructions for generating executables from the sidaJib file in the VADS libraries 
on the search list. Besides information generated by the compiler, these directives also include 
WITHn directives that allow the automatic linking of object modules compiled from other 
languages or Ada object modules not named in context clauses in the Ada source. Any 
number of WITH directives may be placed into a library, but they must be numbered 
contiguously beginning at WITHl. The directives are recorded in the library's adaJib file and 
have the following form. 

WTrniiLINKiobjectJile: 
WlTBliUNKiarchiveJilei 

WITH directives may placed in the local Ada libraries or in any VADS library on the search 
list. 

A WITH directive in a local VADS library or earlier on the library search list will hide the 
same numbered WITH directive in a library later in the library search list. 

Use the tool a.lnfo to change or report library directives in the current library. 

All arguments after unitjname are passed on to the linker. These may be options for it, 
archive libraries, library abbreviations, or object files. 

VADSJocation/bin/aJd is a wrapper program that executes the correct executable based upon 
directives visible in the ada«Ub file. This permits multiple VADS compilers to exist on the 
same host. The -sh option prints the name of the actual executable file. 

OPTIONS 

-E unitjtame (elaborate) Elaborate unitjtame as early in the elaboration order as possible. 

■^F (files) Print a list of dependent files in order and suppress linking. 

--0 executablejile 

(output) Use the specified file name the name of the output rather than the 
default, a.out. 

-sh (show) Display the name of the tool executable but do not execute it. -U 

(units) Print a Ust of dependent units in order and suppress linking. 

^v (verbose) Print the linker command before executing it. 

--V (verify) Print the linker command but suppress execution. 

FILES 

VADSJocation/$X2^A^rAh 

startup and standard library routines 
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,objects/^ Ada object files 

a. out default output file 

SEE ALSO 

Operating system documentation, ld(l) 

DIAGNOSTICS 

Self-explanatory diagnostics are produced for missing files, etc. Occasional additional 
messages are produced by the linker. 
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NAME 'I 

aJist - produce program listing with line numbers 

SYNOPSIS 

a.list [-N] ada^sQwrc^#a 

DESCRIPTION 

a.list provides a convenient way of producing a listing for programs containing no errors that 
closely resembles the output of a.error. The listing is written to the standard output and may 
be piped or redirected to a file. 

OPTION 

-N (no) Suppress line numbers. 

SEK ALSO 

[VADS Reference], a^fsrror? a.pr. 
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NAME 

a.ls - list compiled programs 

SYNOPSIS 

a.ls [options] [unit_name] ... [-f ada^source.a ...] 

DESCRIPTION 

a.ls provides a list of the units compiled in the current VADS directory. Options are pro- 
vided to give more or less extensive information, to change the format of the list, or to pro- 
vide a list of compiled units occurring in specified source files. Additionally, unit_name can 
be specified as a regular expression to match groups of units, (If the regular expression con- 
tains any of the shell's meta-characters, the expression must be quoted.) 

Without the -1 or -v options, a.ls prints output in multiple columns. This can be overridden 
with the -1 (single) option. 

The options -F, -1, and ~v (in increasing order of listing detail) are mutually exclusive. If 
more than one of these three is given, the Usting will be that with the most detail. 

OPTIONS 

~a (all) List all units visible in libraries in the library search list. 

-b (body) Limit output to unit bodies. 

-f filename (file) List only units found in /?/ename. 

-F (suffix) List unit bodies with a trailing #. 

-1 (long) List source file date, net file date, unit, and unit type. 

-s (specification) Limit output to unit specifications. 

-V (verbose) List source file name, source file date, net file date, and unit. 

-1 (single) Print output in a single column. 

SEE ALSO 

Operating system documentation for regular expressions in ed(l). 



MIPS Computer Systems, Inc. February 17, 1989 Page 1 



A.MAKE ( 1 ) RISC/os Programmer's Reference A.MAKE ( 1 ) 



NAME 

a.make - recompile source files in dependency order 

SYNOPSIS 

a.make [options] [unit jaame] , . , [ld„options] [-f ada_source.a ,..] 
a«make [options] [path/unit_name]... [Id^options] [-f ada_source.a ...] 

DESCRIPTION 

This utility determines which files must be recompiled in order to produce a current 
executable file with unit^name as the main unit. It also calls aJd to create the appropriate 
executable, if and only if uniCname is a procedure or an integer function; otherwise, it just 
ensures that the named unit is up-to-date, recompiling any dependencies if necessary. 

The utiUty uses DIANA net files to determine the correct order of compilation and 
elaboration. 

a.make will have no knowledge of any source file (fooM) until that file has been compiled in a 
way that changes the program library. Unless the -f option is used, this requires thaXfoo.a be 
compiled 'by hand' at least once. Unless the -U or -D option is given, the file must compile 
successfully or else the program library will remain unchanged. A single compilation is 
sufficient (unless syntax errors are present) if the ~U option is used to force changes to the 
program library. In any case, syntax errors must be corrected before the file will be 'seen' by 
a.make. 

VADSJocation/bin/a.make is a wrapper program that executes the correct executable based 
upon directives visible in the ada.lib file. This permits multiple VADS compilers to exist on 
the same host. The -sh option prints the name of the actual executable file. 

Supplied names and unknown options are passed to aJd. 

OPTIONS 

-A VADSJibrary [-A VADSJibrary] ... 

(add) Bring the listed libraries up to date if necessary. 

--All (all) Bring all libraries on the library search path up to date. 

-C compiled (compiler) Use the string compiler in recompiling the required units. This 
option is normally used to provide specific options to the compiler. For 
example, to call the compiler with the optimizing option and invoke the vi(l) 
editor on compilation errors, use a command of the following type, 
a.make -C "ada -ev" [other commands] 

-D (dependencies) List the file-to-file dependencies. 

-t adajsourceM ... 

(files) Treat remaining non-option arguments as file names in the current 
VADS library to compile. All units in these files will be brought up to date; -f 
may be used with one of the other options to print actions or dependencies 
without executing them, but must be the last option given. 

--I adajsource.a 

(if) List actions that would be taken if adajsource.a were changed. 

-L ''linked (linker) Use the string linker in linking the required units. This option can be 

used to provide unusual options to ajd when using a^make. 

-O[0-9] (optimize) Invoke the code optimizer (no space before the digit). An 

optional digit limits the number of optimization passes; without the -O 
option, one pass is made; -GO prevents optimizatioju; O with no digit 
optimizes as far as possible. 

-gl Have the compiler produce additional symbol label informatin for accurate 
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but limited symbolic debugging of partially optimixes code. 

~-g "or" -gl Have the compiler produce additional symbol table information for full 
symbolic debugging and not do optimizations that limit full symbolic 
debugging. -g2 is the defult. 

-g3 Have the compiler produce additional symbol table information for full 

symbolic debugging for fully optimized code. This option makes the debugger 
inaccurate. 

-^S (suppress) Apply pragma SUPPRESS to the entire compilation. 

-sh (show) Display the name of the tool executable but do not execute it. 

-U (units) Li3t the list of dependent units in order, but do not link. 

-y (verbose) List the recompilation commands as they are executed. 

-V (verify) List the recompilation commands that would be executed, but do not 

execute them. 



Page 2 February 16, 1989 MIPS Computer Systems, Inc. 



A.MKLIB ( 1 ) RISC/os Programmer's Reference A.MKLIB ( 1 ) 



c 



NAME 

a.mklib - make library directory 

SYNTAX 

a^mklib [-F -f -i -v] [4 target] [new„VADSJibrary [parent_VADSJibrary]] 

DESCRIPTION 

a.mklib creates and initializes a new VADS library directory, creating three iOile? (GVASjable, 
adaJib, and gnrxJib) and four directories (Jines, Jmports, .nets, and 

.objects). It constructs library pointers in adaJib to all libraries available from the parent 
library and to the parent library itself. As a result, Ada units in the new library can reference 
all Ada units defined by the parent library and all units that were accessible from the parent 
library, 

Ji parent J/ADSJibrary is unspecified, the default libraries are verdixlib and standard. 

The tool a.vadsrc may also be used to create a local configuration file called ,vadsrc either in 
the current directory, or in the user's $HOME directory, so that future libraries created in a 
directory below the current directory or $HOME directory will reference a particular VADS 
version. 

If newJVADSJibrary is unspecified, the current working directory is initialized. 

The ~f option will force initialization of the VADS library structure, overwriting any existing 
components and deleting any existing lock files. 

Without the -F option, a.mklib cannot create libraries named standard, verdixlib, or publidib. 

A Hst of available targets can be obtained with the -i option or with the tool a.vadsrc 

OPTIONS ^ 

-f (force) Create VADS library structure even if some components are I 

already present. 

-F (force name) Allow creation of VADS library with a restricted name. 

-i (interactive) Display all versions of VADS installed on the system and 

prompt for selection of VADS version unless modified with the -t 
option. 

-t target (target) Create a library for a specific target machine. 

-V (verbose) Display the library search list and target directives, 

EXAMPLE 

If the user is positioned at the directory /usr/babbage/code and the VADS library olddir exists 
below it in the UNIX hierarchy, the command 

a.mklib newdir olddir 

creates the library directory /usr/babbage/code/newdir and provides access to the Ada 
compilation units previously compiled in the olddir library directory. Any units available to 
olddir from other libraries are now available from newdir as well. 

FILES 

^vadsrc local default configuration file 

/usr/lib/VADS VADS version reference file 

DIAGNOSTICS 

An error is reported and no action is taken (without the ^f option) if new^VADSJibraiy 
contains any VADS components or lock files or if the name specified exists but is not a 
directory. 
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SEE ALSO 

[VADS Reference], a.cleanlib, a.rmlib, a.vadsrc. 
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NAME 

a.pathxs ^ report or change VADS library search list 

SYNTAX 

a.path [options] [VADSJibraiyl [VADSJibrary2]] 

DESCRIPTION 

A list of libraries to be searched during compilation i^ maintained in the current VADS library 
directory in the file adaJib. a.path changes or reports the Ust of library names contained 
there. During compilation ^ any program units not found in the current library will be searched 
for in the VADS libraries listed on the search Ust, If the unit is not found in the first VADS 
library, it is searched for in the second, and so on in li3ted order. When a.path is used with 
no options, it reports the contents of the current library search list, one library to a line. 

OPTIONS 

-B VADS Jibraryl [VADS Jibrary2] 

(append) Append VADSJibraryl after VADSJibrary2. With a single 
argument, append VADSJibraryl to the end of the library search list, 

-i VADSJibrary [VADSJibrary2] 

(insert) Insert VADSJibraryl before VADSJibrary2. With a single argument, 
insert VADSJibraryl at the beginning of the Ust. 

-Y VADSJibraryl 

(remove) Remove VADSJibraryl from the library search list. 

--v (verbose) Display path as it is changed, 

-t (target) Display library search list and target information. 

-x VADSJibraryl 

(except) Remove all except VADSJibraryl from the Ust. 

BUGS 

Removing a library name from the library search Ust does not remove compUation information 
from the referenced libraries. 

Maximum length of the library search Ust is 2048 characters. 



( 
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NAME 



a.pr - format source code 



SYNTAX 

a.pr [options] [ada„source.a] 

DESCRIPTION 

a.pr reformats Ada source code according to the options specified in a runtime configuration 
file with the name .prrc. This allows users to tailor a.pr for individual Ada coding standards. 
The configuration file may be located either in the user's current working directory or the 
home directory. 

Additionally, options can be specified on the command line that override those in the 
configuration file. The options are Usted below. 

Invoked without a filename, a.pr reads its input from standard input. 

Error and warning messages are written to standard error. 

,prrc CONFIGURATION FILE OPTIONS 

(Defaults shown in brackets.) 

align^cmts where aUgn comments to the right of the longest line {line) or the longest line 
containing a comment (comment) [comment] 

Specify maximum number of characters of code per line including 
comment and indentation; any line extending over this limit will be 
continued on the next line; vaUd range is from 20 .. 500 [132]. 

print all comments in the specified case: upper, lower, same [same] 

print all identifiers in the specified case: upper, lower, same [upper] 

Specify amount of indentation between levels; valid range is 1 .. 8 [8]. 

Specify maximum number of lines allowed on a page; valid range is 
froml.. 1000 [55]. 

Specify starting margin for top-most level; valid range is from ,. 15 
[0]. 

Paginate only when pragma PAGE is encountered. [page] 

suppress warning messages regarding line length greater than desired 
[provide warnings] 

Set page size; perform pagination with blank lines; valid range is from 1 
.. 1000 [paginate using form feeds]. 

Start each library unit (indicated by a WITH clause) on a new page [do 
not start on new page]. 

print record on either the same line (same) or on the next one (next) 
[same] 

print all reserved words in the specified case: upper, lower, same [lower] 

Print tabs for indentation whenever the number of spaces needed for 
indentation is greater than or equal to the specified number; valid range 
is from .. 8; if tabs is specified, indentation will be performed with 
blanks [8]. 

a.pr COMMAND LINE OPTIONS 

(Defaults shown in brackets.) 

-ac (align comment) Align comments to the right of the longest line that contains 



chars number 

comment case 
ident case 
indent number 
lines number 

margin number 

no^page 
no_waming 

page number 

pageju 

record where 

reserved case 
tabs number 
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a Gomment [default] . 

-al (align line) Align coinments to the right of the longest line, regardless of 

whether it contains a comment [-ac]. 

-c number (characters) Specify maximum number of characters of source code allowed 

on a line, Valid range is from 20 ., 500 [132]. 

■-cl (comments lower) Print comments in lower case [-cs]. 

~cs (comments same) Print comments as in source code [default]. 

--cu (comments upper) Print comments in upper case [-cs]. 

"-i number (indent) Specify indentation between levels. Valid range is from 1 .. 8 [8]. 

-il (identifiers lower) Print identifiers in lower case [4u]. 

-is (identifiers same) Print identifiers as in source code [-iu], 

-ill (identifiers upper) Print identifiers in upper case [default]. 

-1 number (lines) Specify maximum number of lines allowed on a page, V^lid range is 

from 1 .. 1000 [55]. 

--^m number (margin) Specify starting margin for top-most level. Valid range is from .. 
15.[0]. 

-nl (no page library unit) Do not start a new page for each library unit [default], 

-np (no pagination) Specify no pagination. Pagination will occur only when 

pragma PAGE is encountered [-pg]. 

-nw (no warnings) Suppress warning messages regarding line length [-w]. 

-p number (page) Specify page size. Valid range is from 1 .. 1000 [-pg], 

-pg (pagination) Paginate using form feeds [default]. 

-pi (page library) Start a new page whenever a library unit is encountered [-nl]. 

-rl (reserved lower) Print reserved wordjs in lower case [default], 

-RN (record next) Print RECORD on the line following type ox for [-RS]. 

-rs (reserved same) Print reserved words as in source code [-rl], 

-RS (record same) Print RECORD on the same line as type ox for [default]. 

-ru (reserved upper) Print reserved words in upper case [-rl]. 

-t number (tabs) Specify tabs for indentation whenever the number of spaces needed i^ 

greater than or equal to the specified number. IS -t is specified, indentation 
will be performed with spaces. Valid range is from 0.. 8 [8], 



( 



(warning) Provide warning messages regarding line lengths greater than desired 
[default]. 
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NAME 

a.rm ~ remove source unit and library information 

SYNTAX 

a.rm [options] unit_name 
a.rm [options] [ada_source.a] 

DESCRIPTION 

The a.rm command is executed while positioned in ^ VADS directory. It removes all 
information associated with the named unit(s) or file(s). When uniLname is specified, the 
corresponding files in .nets, .objects, and Mnes are removed and the adaJib entries are 
delated. 

When a file name adajsourceM is given, all net, object, and line number files are removed for 
each unit defined in the file, and the appropriate entries are deleted from adaJib. A name 
ending in m i$ taken to be an Ada source file name unless the -u option is given. 

Unit names with dotted notation such as aaa.bbb or aaa.bbbxcc are taken to be the names of 
Ada subunits. 

OPTIONS 

-b (body) Delete the bodies of the specified units named files. 

~f (file) Remove the Ada source file in addition to the compiler-generated files 

whenever all units in a file are deleted. 

-i (interactive) Prompt for confirmation before deleting information for any 

units. 

-s (specification) Remove the compilation information for the specifications of 

the specified units. 

-u (unit) Force the next name to be treated as a unit even though it ends in .a. 

-V (verbose) List the units ais they are removed. 

~V (verify) List the units that would be removed, but do not remove them. 
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NAME 

a.rmlib - remove compilation library 

SYNTAX 

a.rmlib [~f -F] [VADSJibrary] 

DESCRIPTION 

a.rmlib removes all VADS library components from VADSJibrary or from the current library 
if no argument is given. It removes three fiU^ (GVASjable, adaJib, and gnrxJib), four 
directories {dines, .imports, ,nets, and .objects), and lock files, if the --f option is used. The 
directory itself, any other files it contains, and any other si^bordinate directories are 
untouched. 

HyAZ)5'Ji&rflry is unspecified, the current VADS library is used. 

If a.rmlib cannot find every library component or lock files exist, it will abort without 
removing any files unless the -f (force) option is given. 

Without the --F option a.rmlib cannot operate in a library bearing the name standard, 
verdixlib, or pubUclib- 

OPTION 

-f (force) Clean VADS library structure even if some components are missing or 

lock files exist. 

-¥ (force name) Allow the cleaning of the VADS library structure of a library, 

having a restricted name. 

DIAGNOSTICS 

An error is reported and no action is taken (without the --f option) if VADSJibrary contains 
an incomplete set of components or a lock file. 

An error message will be issued if any files or directories are not accessible for deletion. 

SEE ALSO 

[VADS Reference], a.mklib, a^deanlib 

BUGS 

The directory name for the removed library is left in dependent library paths. This blocks 
compilation in any dependent libraries until a.path is used to remove the path entry that 
specifies this directory. Compilation coitfd also proceed if a VADS library is re-created in the 
named directory from which the library information was removed. 
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NAME 

a,run - download and execute a program on the target board [cross compilers only] 

SYNTAX 

a.run [options] [executable_file] 

DESCRIPTION 

a.run downloads and runs a VOX format file on a target board. The interface (TDM or 
emulator) must be set up as described, and the target board correctly connected as required by 
a.db. 

If the Ada program fails with a runtime error on the board, a.run reports the error and the PC 
at the time of the failure. 

If executablejile is not given, the name a.vox is used. 

VADSJocation/bin/a.run is a wrapper program that executes the correct executable based 
upon the names in the adaJib file or indicated by the -t option. This permits multiple VADS 
compilers to exist on the same host. The -sh option prints the name of the actual executable 
file. 

OPTIONS 

-b (benchmark) print the elapsed time for running the program. 

~c (checksum) do not checksum the executable load sections. 

--1 (load) load executable^file only, do not execute. 

-s address (start) set the starting program counter to address (must be a hexadecimal 

number without delimiting characters) 

--sb (show) display the name of the tool executable, but do not execute it. 

-t target^name (target) specifies which target to use. Can be used to run in a directory in 
which no ada library present or to override the target named by the ada.lib 
file. The -t option requires the -1 or ~s option, as it does not get the start 
address from the ada.ft6^/e. 

-T number (timeout) stop if the program doesn't return after number seconds. (0 means 
no timeout). Default is 240. 

-V (verbose) show downloading progress 
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NAME 

a,tags -^ create a tags file 

SYNTAX 

a.tags [options] ada_source, a ... 

DESCRIPTION 

a,tags makes a tags file from the specified Ada source(s). The operation is similar to the 
UNIX ctags(l) command with modifications for Ada-specific features. 

Each Une of the tags file lists the object name^ the file in which it is defined, and search 
patterns for locating each object's definition, UNIX editors such as vi(l) or ex(l) can use the 
tags file to locate units and, if the -t option was used to create the tags filQ? to locate types as 
well. Create the mg^y file with the command 

a,tags *.a 

For example, to edit unit END^PROG without specifying the file that contains it, type the following 
command. 

vi4END^PR0G 

Ada allows unit name overloading? and a,tags requires special conventions to access different 
units having the same name. Ada specifications are named by prefacing the Ada simple me 
with s#. Bodies are named with the unmodified Ada name. Stubs for separates are named 
by prefacing the Ada simple name with stuh#. 

Nested packages, subprograms, types, generics, and task definitions are always listed with 
their full name (Ada expanded name) with any tag prefaces added to the simple name. 
Simple names for nested units are Usted only if the simple name is unique across all other 
tags. Thus the user may use the simple name if it is unique and may always use the full name. 

Fully qualified overloaded names within a file are not differentiated. However, the tag 
identifies the correct file, and repeated application of the search pattern will find the desired 
subprogram. The search pattern is generalized to match all versions of the overloaded 
subprogram; this generalization may cause the pattern to recognize things other than the 
desired unit. Identical fully quaUfled names across files are not handled. 

The -x and -v options provide listings on the standard output; all other options refer to the file 
tags generated for use by ex or vi, 

OPTIONS 

-a (append) Append to the tags file. 

--B (backward) Record backward searching patterns (?). 

-F (forward) Record forward searching patterns (/). Default. 

-t (types) Create tags for types also. 

--v (vgrind) Generate an index with line numbers for vgririd(l) on the standard 

output. 

-w (warnings) Suppress warning messages. 

--X (cross) Generate an indexed list of all tags on the standard output. 

SEE ALSO 

Operating system documentation^ ctags(l). 



BUGS 



When using ex or vi with the -^t option, the command Une must contain the desired unit or 
type in the same case (upper or lower) as its occurrence in the source file. 
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NAME 

a.vadsrc - display available VADS versions and create a default library configuration file 

SYNTAX 

a.vadsrc [-1] 

DESCRIPTION 

When multiple VADS targets or versions are present on the same system, a.vadsrc is useful to 
control the default version or target processor for which libraries are created. 

With no option, a.vadsrc simply reports the installed VADS version. 

If the ~i (interactive) option is used, the tool prpmpts for selection of a VADS version and 
creates a .vadsrc file in the current directory. 

OPTIONS 

-i (interactive) Show all versions of VADS installed on the system and prompt 

for a selection. 

Files 

/usrIlib/VADS VADS version reference file 

SEE ALSO 

\yADS Reference], a.mklib. 
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NAME 

a.view - establish command abbreviations and history mechanism for C shell 

SYNTAX 

source a.view 

DESCRIPTION 

a. view defines a number of aliases that simplify and enhance the use of the basic VADS 
commands for user3 of the C shell. The alias definitions allow a file name to be set once and 
thereafter ^lias commands use it until it is changed, Similarly, a main unit name need be 
entered only once. (It need not be entered at all if it is the same as the last specified file 
name prefix.) Compilation and linking aUases enter history and timing information into the 
adaMstory file. 

For a full description, see the VADS Users Guid^ , Additional Tools, a^view. 

To use the aliases without any alteration, put the following single line in the Aogin file, 
source yAZ)5J(?carto/t/bin/a.view 

This defines the aliases for interactive use. This line must appear at the beginning of scripts 
using these ahases. 

Aliases defined in a.view are summarized below. The term ^tracking' is used to indicate 
whether or not the main unit name is set to the same as the file name prefix. 

ALIASES 

Compile established file name, put errors in adaxrrorsJ filename, and history 
entry in adaMstory, 

Compile and run the debugger. 

List last entry in ada.history. 

List established file name using more. 

Link the established main unit. 

Execute a.make using file name specified in sm and put errors in 
adaxrrors/unitjname.m, 

compile and optimize code. 

Edit the established file name with vi. 

Execute the established main unit. 

Execute a main unit and put timing entry into ada^history . 

List erroneous lines and diagnostics from last compilation of estabUshed file 
name. 

List established file name with diagnostics from last compilation interspersed. 

Edit the established file name with vi with diagnostics from last compilation 
interspersed; 

Set file name prefix. If new working directory, then set tracking on. If 
tracking is on, then set main unit. 

Set file name prefix and main unit; set tracking on. 

Set main unit and set tracking off, so that the main unit name does not 
change with s command. 

Print settings of file name prefix and main unit. 

List status for the last executed VADS command. 



a 

ad 

ah 

al 

aid 

am 

ao 
av 
ax 
axtime 



el 
ev 

s name 

sb name 
sm name 

sp 

vs 
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In the commands that take name, additional arguments are ignored, and any traiUng m is 
stripped. (The prefix is desired for the file name,) In addition, only the tail component of 
name (the part following the last /) is used to set the main unit. (Main unit is an Ada unit 
name, which does not allow 7'). The intention of this convention is to allow the use of file 
name substitution for easy specification of a full file name and main unit. 

For example, if the current directory contains the files tasking Jimit Jest, a (Ada source) and 
tasking Jimit jest,out (extcntsblQ object) and if there were no other files beginning with tas, 
the command s tas* would set the file name prefix to tasking Jimit Jest and the main unit to 
the same string. When the main unit name dUfers from the file name, the sm command may 
be used. 

In all other commands, additional arguments are passed to the underlying VADS command. 
Thus 

aid 4termcap 

will cause the linker to search the termcap library in addition to standard libraries. 



FILES 



ada.history history of compilations and results 

ada, errors directory containing error files from compilations 

DIAGNOSTICS 

Warnings are produced if any set command is used in a non-VADS library directory or if the 
specified source file does not exist in the library. 
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NAME I 

a.which - determine which project library contains a unit 

SYNTAX 

aavhich [options] [unit^name] 
a.which [options] [path/unit_name] 

DESCRIPTION 

a.which lists the name of the source file that defines the version of unitjiame visible in the 
current VADS library. The program Hbrary search sequence may also be printed, The -b 
(body) option Hsts the source file location of the unit body. Without this option, the unit's 
specification is located, 

OPTIONS 

--b (body) Give the location of the body. 

■"sh (show) Display the name of the tpol executable but do not execute it. 

-"V (verbose) Give the library search Ust, 

BUGS 

An option is needed so that hidden units can be printed as well to allow programmers to 
identify unit naming conflicts. 
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NAME 



ada - Ada compiler 



SYNTAX 

ada [options] [ada_source.a]... [linker_options] [object_file.o]... 

DESCRIPTION 

The command ada executes the Ada compiler and compiles the named Ada source file, 
ending with the la suffix. The file must reside in a VADS library directory. The ada Mb file in 
this directory is modified after each Ada unit is compiled. 

The object for each compiled Ada unit is left in a file with with the same name as that of the 
source with .01, ,02, etc. substituted for m. The -o option can be used to produce an 
executable with a name other than a.out, the default. For cross compilers, the default name 
is a.vox. 

By default, ada produces only object and net files. If the -M option is used, the compiler 
automatically invokes aJd and builds a complete program wih the named library unit as the 
main program. 

Non-Ada object files (.o files produced by a compiler for another language) may be given as 
arguments to ada. These files will be passed on to the linker and will be linked with the 
specified Ada object files. 

Command line options may be specified in any order, but the order of compilation and the 
order of the files to be passed to the linker can be significant. 

Several VADS compilers may be simultaneously available on a single system. Because the 
ada command in any VADS_location/foz'n on a system will execute the correct compiler 
components based upon visible library directives, the option -sh is provided to print thQ name 
of the components actually executed. 

Program listings with a disassembly of machine instructions are generated by a.db or a.das. 



OPTIONS 



-a file_name 
-d 



-Efile 

-E directory 



-el 
-El 



(archive) treat filejtame as an ar file. Since archive files end with m, -a 
is used to distinguish archive files from Ada source files. 

(dependencies) analyze for dependencies only. Do not do semantic 
analysis or code generation. Update the library, marking any defined 
units as uncompiled. The -d option is used by a, make to establish 
dependencies among new files. 

(error) process compilation error messages using a. error and direct it to 
stdout.- only the source lines containing errors are listed. Only one -e 
or -E option should be used. 



(error output) without a file or directory argument, ada processes error 
messages using a.error and directs the output to stdout; the raw error 
messages are left in ada_source,err. If a file pathname is given, the raw 
error messages are placed in that file. If a directory argument is 
supplied, the raw error output is placed in dir/source.err. Only one -e 
or -E option should be used. 

(error listing) intersperse error messages among source lines and direct 
to stdout. 
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-El file 

'M directory 



-ev 



-g3 

"1 fllejabbreviation 

-M unitjtame 

-M adajsource.a 
-o executablejile 

-OX 

-02 

-R VADSJibrary 



(error listing) same as the -E option^ except that source listing with 
errors is produced. 

(error vi) process syntax error messages using a.error, embed them in 
the source file^ and call the environment editor ERROR^EDITGR. (If 
ERROR^EDITOR is defined, the environment variable 
ERROR^PATTERN should also be defined. ERROR_PATTERN is an 
editor search command that locates the first occurrence of *###' in the 
error file.) If no editor is specifed, call vi. 

Have the compiler produce additional symbol table information for 
accurate but limited symbolip debugging of partially optimixed code. 

Have the compiler produce additinal symbol table information for full 
symbolic debugging and not do optimizations that Umit full symbolic 
debugging. ~-g2 is the default. 

Have the compiler produce additional sybol table information for full 
symbolic debugging for fully optimized code. This option makes the 
debugger inaccurate. 



i 



(link) Link this library file, 
abbreviation.) See also 



(Do not space between the -land the file 



Operating system documentation^ ld(l). 

(main) produce an executable program using the named unit as the main 
program. The unit must be either a parameterless procedure or a 
parameterless function returning an integer. The executable program 
will be left in the file a,out unless overridden with the -o option. 

(main) like «M unitjiame, except that the unit name is assumed to be 
the root name of the .a file {for f 00 m the unit is/00). Only one m file 
may be preceded by -M. 

(output) this option is to be used in conjunction with the -M option. 
executablejile is the name of the executable rather than the default 
a.out. 

Turn off all optimizations. 

Turn on all MIPS optimizations that can be done quickly and do one 
pass using the Verdk optimizer. This is the default. 

Invoke the MIPS global ucode optimizer and optimize as far as possible 
using the Verdix optimizer. (MIPS global ucode optimizer not 
supported in this release.) -O is the same as ~02. 

(recompile instantiation) force analysis of all generic instantiations, 
causing reinstantiation of any that are out of date. 

(suppress) apply pragma SUPPRESS to the entire compilation for all 
suppressible checks. 

(timing) print timing information for the compilation. 

(verbose) print compiler version number, date and time of compilation, 
name of file compiled, command input line, total compilation time, and 
error summary line. 

(warnings) suppress warning diagnostics. 
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-W c argl,[arg2...] Pass the argument[s] argi to a compiler pass, where c is one of the 
characters in the next table that designates the pass. 



D 



Pass 


Character 


include 


h 


backend 




driver 




ucgen 


G 


ujoin 


J 


uld 


u 


usplit 


s 


umesrge 


m 


uopt 


o 


ugen 


c 


asl 


b 



SEE ALSO 

[VADS Reference] a.db, a^error, aJd, a.mklib, ^.das and Operating system documentation, 
ld(l) 

DIAGNOSTICS 

The diagnostics produced by the VADS compiler are intended to be self-explanatory. Most 
refer to the RM. Each RM reference includes a section number and optionally, a paragraph 
nun^ber enclosed in parentheses. 
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NAME 

addbib - create or extend bibliographic database 

SYNOPSIS 

addbib [ — p promptfile ] [ — a ] database 

DESCRIPTION 

When this program starts up, answering 'V to the initial "Instructions?'' prompt yields direc- 
tions; typing "n'' or RETURN skips them, addbib then prompts for various bibliographic fieldSj 
reads responses from the terminal, and sends output records to a database. A null response 
(just return) means to leave out that field. A minus sign (-) means to go back to the previ- 
ous field. A trailing backslash allows a field to be continued on the next line. The repeating 
"Continue?" prompt allows the user either to resume by typing "y'' or RCTURN, to quit the 
current session by typing "n" or "q'^ or to edit the database with ^ny system editor (vi, ex, 
edit, ed). 

The —a option suppresses prompting for an abstract; asking for an abstract is the default. 
Abstracts are ended with a CTRL-d. The — p option causes addbib to use a new prompting 
skeleton, defined in promptfile. This file should contain prompt strings, a tab, and the key- 
letters to be written to the database. 

The most common key-letters and their meanings are given below, addbib insulates you from 
these key-letters, since it gives you prompts in English, but if you edit the bibliography file 
later on, you will need to know this information. 

%A Author's name 

%B Book containing article referenced 

%C City (place of publication) ^ 

%D Date of publication I 

%E Editor of book containing article referenced 

%F Footnote number or label (suppUed by refer) 

%G Government order number 

%H Header commentary, printed before reference 

%I Issuer (pubHsher) 

%J Journal containing article 

%K Keywords to use in locating reference 

%L Label field used by -^k option of refer 

%M Bell Labs Memorandum (undefined) 

%N Number within volume 

%0 Other commentary, printed at end of reference 

%F Page number(s) 

%Q Corporate or Foreign Author (unreversed) 

%R Report, paper, or thesis (unpubUshed) 

%S Series title 

%T Title of article or book 

%V Volume number 

%X Abstract - used by roffbib, not by refer 

%Y,Z ignored by refer 

Except for 'A', each field should be given just once. Only relevant fields should be supplied. 
An example is: 



%A Bill Tuthill 

%T Refer - A Bibliography System 

%I Computing Services 
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%C Berkeley 
%D 1982 

%0 UNX 4.3,5. 

FILES 

promptfile optional file to define prompting 

SEE ALSO 

refer(l), sortbib(l), roffbib(l), indxbib(l), lookbib(l) 

AUTHORS 

Al Stangenberger, Bill Tuthill 
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NAME 

apply - apply a command to a set of arguments 

SYNOPSIS 

^ppiy [ —PC ] [ """^ ] command args ,.. 

DESCRIPTION 

apply runs the named command on each argument arg in turn. Normally arguments are 
chosen singly; the optional number n specifies the number of arguments to be passed to com- 
mand. If n is zero, command is run without arguments once for each arg. Character sequences 
of the form %d in command^ where rf is a digit from 1 to 9, are replaced by the d^th following 
unused arg. If any such sequences occur, n is ignored, and the number of arguments passed to 
command is the maximum value of d in command. The character *%' may be changed by the 
—SI option. 

Examples: 

apply echo * 
is similar to ls(X); 

apply -2 cmp al bl a2 b2 ... 
compares the 'a' files to the 'b' files; 

apply -0 who 12 3 4 5 
runs who(l) 5 times; and 

apply In %1 /usr/joe' * 
links all files in the current directory to the directory /usr/joe. 

SEE ALSO 

sh(l) 

AUTHOR 

Rob Pike 

BUGS 

Shell metacharacters in command may have bizarre effects; it is best to enclose complicated 
commands in single quotes ' \ 

There is no way to pass a literal '%2' if '%^ is the argument expansion character. 



( 
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NAME 

apropos - locate commands by keyword lookup 

SYNOPSIS 

apropos keyword ... 

DESCRIPTION 

apropos shows which manual sections contain instances of any of the given keywords in their 
title. Each word is considered separately and case of letters is ignored. Words which are part 
of other words are considered; thus, when looking for compile, apropos will find all instances 
of 'compiler' also. Try 

apropos password 

and 

apropos editor 

If the line starts 'name(section) ...' you can do 'man section name' to get the documentation 
for it. Try 'apropos format' and then 'man 3s printf to get the manual on the subroutine 

printf. 

apropos is actually just the -k option to the man{l) command. 

FILES 

/usr/man/whatis data base 

SEE ALSO 

man(l), whatis(l), catman(8) 

AUTHOR 

William Joy 
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NAME 

ar - archive and library maintainer 

SYNOPSIS 

ar option [posname ] fiieX ... fileN 

DESCRIPTION 

The archiver (ar) maintains groups of files as a single archive file. Generally, you use this util- 
ity to create and update library files that the link editor uses; however, you can use the 
archiver for any similar purpose. NOTE: This version uses a portable ASCII-format archive 
that you can use on various machines that run UNIX. 

In the text, option refers to a character (from the set drqtpmx) that you can concatenate with 
one or more of svuaibclo. A suboption refers to options (from the set abiou) that you can 
only use with other options. 

The options do these things: 

d Deletes the specified files from the archive file. 

r Replaces the specified files in the archive file. If you use the suboption u with r, the 

archiver only replaces those files that have 'last-modified' dates later than the archive 
files. If you use a positioning character (from the set abi) you must specify the 
posname argument to tell the archiver to put the new files after (a) or before (b or i). 
Otherwise, the archiver puts new files at the end of the archive, 

q Appends the specified files to the end of the archive file. The archiver does not 

accept suboption positioning characters with the q option. It also does not check 
whether the files you want to add already exist in the archive. Use the q option only 
to avoid quadratic behavior when you create a large archive piece by piece. 

t Prints a table of contents for the files in the archive file. If you don't specify any file 

names, the archiver builds a t^ble of contents for all files. If you specify file names, 
the archiver builds a table of contents only for those files. 

p Prints the specified files from the archive. 

m Moves the specified files to the end of the archive. If you specify a positioning charac- 

ter, you must also specify th^ pomame (as in option r) to tell the archiver where to 
move the files. 

X Extracts the specified files froni the archive. If you don't specify any file names, the 

archiver extracts all files. When it extracts files, the archiver does not change any file. 
Normally, the last-modified' date for each extracted file shows the date when some- 
one extracted it; however, when you use o, the archiver resets the last-modified' date 
to the date recorded in the archive. 

s Makes a symbol definition (symdef file) as the first file of an archive. This file con- 

tains a hash table of ranlib structures and a corresponding string table. The symdef 
file's name is based on the byte ordering of the hash table and the byte ordering of the 
file's target machine. Files must be consistent in their target byte ordering before the 
archiver can create a symdef file. If you change the archive contents, the symdef file 
becomes obsolete because the archive file's name changes. If you specify *s', the 
archiver creates the symdef file as its last action before finishing execution. You must 
specify at least one other archive option (m, p, q, r, or t) when you use the s option. 
For UMIPS-V, archives include member objects based on the deifinition of a common 
object only. For UMIPS-BSD, they define the common object, but do not include the 
object. 

V Gives a verbose file-by-file description as the archiver makes a new archive file from | 

an old archive and its constituent files. When you use this option with t, the archiver ^- 
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lists all information about the files in the archive. When you use this option with p, 
the archiver precedes each file with a name. 

c Suppresses the normal message that the archiver prints when it creates the specified 

archive file. Normally, the archiver creates the specified archiver file when it needs to. 

1 Puts temporary files in the local directory. Normally, the archiver puts its temporary 

files in the directory /tmp. 

The suboptioiis do these things: 

a Specifies that the file goes after the existing file (posname). Use this suboptjon with 

the m or r options. 

b Specifies that the file goes before the existing file (posname). Use this suboption with 

the m or r options. 

i Specifies that the file goes before the existing file (posname). Use this suboption with 

the m or r options. 

o Forces a newly created file to have the Uast modified' data that it had before it was 

extracted from the archive. Use this suboption with the x option. 

u Prevents the archiver from replacing an existing file unless the replacement is newer 

than the existing file. This option uses the UNIX system 'last modified' data for this 
comparison. Use this suboption with the r option. 



FILES 



/tmp/v* temporaries 

SEE ALSO 

lorder(l), ld(l), odump(l), ar(4), ranhash(3x). 

BUGS 

If you specify the same file twice in an argument list, it can appear twice in the archive file. 

The o option does not change the 'last-modified' date of a file unless you own the extracted 
file or you are the super-user. 
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NAME ■ 

as - MIPvS assembler 

SYNOPSIS 

as [ option ] .., file 

DESCRIPTION 

As, the MIPS assembler, produces files in the following formats: MIPS object code in MIPS 
extended coff format (the normal result) and binary assembly language. As never runs the 
loader. As accepts one type of argument: 

The argument j^/e is assumed to be symbolic assembly language source program. It is assem- 
bled, producing an object file. 

Mas always defines the G preprocessor macros mips, host_mip$, unix and 

LANGUAGE^ASSEMBLY to the C macro preprocessor. It also defines SYSTYPE„SYSV by 
default but this changes if the —systype name option is specified (see the description below). 

The following options are interpreted by as and have the same meaning in cc(l). 

•-•gO Have the assembler produce no symbol table information for symbolic debugging. 
This is the default. 

-gl Have the assembler produce additional symbol table information for accurate but lim- 
ited symbolic debugging of partially optimized code. 

-g or -g2 

Have the assembler produce additional symbol table information for full symboHc 
debugging and not do optimizations that limit full symbolic debugging. 

-g3 Have the assembler produce additional symbol table information for full symbolic ^ 

debugging for fully optimized code. This option makes the debugger inaccurate. I 

— w Suppress warning messages. 

-"P Run only the C macro preprocessor and put the result in a file with the suffix of the 
source file changed to '.i' or if the file has no suffix then a *.i' is added to the source 
file name. The M' fil^ has no *#' lines in it. This sets the ^cpp optiop. 

-E Run only the C macro preprocessor on the file and send the result to the standard out- 
put. This sets the — cpp option. 

•^o output 

Name the final output file output > If this option is used, the file *a.out' is undisturbed. 

--Dname^def 
-^Dname 

Define the name to the C macro preprocessor, as if by '#define'. If no definition is 

given, the name is defined as "1". 

-^Vname 

Remove any initial definition of name . 

--Idir *#mclude' files whose names do not begin with V are always sought first in the direc- 
tory of the file argument, then in directories specified in -I options, and finally in the 
standard directory (/usr/i«clude). 

-I This option will cause '#include' files never to be searched for in the standard direc- 
tory (/usr/include). 

—G num 

Specify the maximum size, in bytes, of a data item that is to be accessed from the glo- 
bal pointer, Num is assumed to be a decimal number. If num is zero, no data is 
accessed from the global pointer. The default value for num is 8 bytes. 
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-v Print the passes as they execute with their arguments and their input and output files. 

-V Print the version of the driver and the versions of all passes. This is done with the 
what{l) command. 

— cpp Run the C macro preprocessor on assembly source files before compiling. This is the 
default for a^(l). 

-^nocpp 

Do not run the C macro preprocessor on assembly source files before compiling. 

Either object file target byte ordering can be produced by as. The default target byte ordering 
matches the machine where the assembler is running. The options — EB and —EL specify the 
target byte ordering (big-endian and little-endian, respectively). The assembler also defines a 
C preprocessor macro for the target byte ordering. These C preprocessor macros are Mff- 
SEB and MIPSEL for big-endian and little-endian bj^e ordering respectively, 

— EB Produce object files targeted for big-endian byte ordering. The C preprocessor macro 
MIPSEB is defined by the assembler. 

—EL Produce object files targeted for little-endian byte ordering. The C preprocessor 
macro MIPSEL is defined by the assembler. 

The following option is specific for as : 

■^m Apply the M4 preprocessor to the source file before assembling it. 

The option described below is primarily used to provide UNIX compilation environments 
other than the native compilation environment. 

— systype name 

Use the named compilation environment name. See compilation (7) for the compila- 
tion environments that are supported and their names. This has the effect of changing 
the standard directory for '#include' files. The new items are located in their usual 
paths but with /name prepended to their paths. Also a preprocessor macro of the 
form SYSTYFE^AME (with name capitalized) is defined in place of the default 
SYSTYPE^SYSV. 

The options described below primarily aid compiler development and are not generally used: 

—He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ a ]. It selects the assembler pass in the same way 
as the — t option. If this option is used, the symbol table file produced and used by 
the passes, is the last component of the source file with the suffix changed to *.T', or a 
*.T' is added if the source file has no suffix. This file is not removed. 

— K Build and use intermediate file names with the last component of the source file's 
name replacing its suffix with the conventional suffix for the type of file (for example 
*.G' file for binary assembly language). If the source file has no suffix the conventional 
suffix is added to the source file name. These intermediate files are never removed 
even when a pass encounters a fatal error. 

'-yVc[c,„J,argl[,arg2,,J 

Pass the argument[s] argi to the compiler pass[es] c[c..]. The c*s are one of [ pab ]. 
The c's selects the compiler pass in the same way as the — t option. 

The options — t[hpab], -^-hpath, and '-'Bstring select a name to use for a particular pass. These 
arguments are processed from left to right so their order is significant. When the -B option is 
encountered, the selection of names takes place using the last — h and — t options. Therefore, 
the — B option is always required when using -h or -t. Sets of these options can be used to 
select any combination of names. 
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-■tlhpab] ( 

Select the names. The names selected are those designated by the characters follow- 
ing the — t option according to the following table: 

Name Character 

include h (gee note below) 

cpp p 

asO a 

asl b , 

If the character 'h' is m the "-t argument then a directory is added to the list of direc- 
tories to be used in searching for '#include' files. This directory name has the form 
COMP^TARGET^ROOT/usr/inchde^rm^ . This directory is to contain the include files 
for the string release of the compiler. The standard directory is still searched. 

•^hpath 

Use path rather than the director)^ where the name is normally found. 

•--Bstnng 

Append string to all names specified by the -^t option. If no --t option has been pro- 
cessed before the ^B^ the — t option is assumed to be "hpab". This Kst designates all 
names. 

Invoking the assembler with a name of the form Sisstring has the same effect as using a 
---Bstring option on the command line. 

If the environment variable COMF_,HOST_ROOT is set, the value is used as the' root directory 
for all pass names rather than the default /• If the environment variable 
COMP_TARGET_R0OT is set, the value is used as the root directory for the includes rather 
than the default /• 



FILES 



If the environment variable ROOTDIR is set, the value is used as the root directory for all 
names rather than the default /usr/. This also affects the standard directory for *#include' 
files, /usr/include . 

If the environment variable TMFDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ t 

Other arguments are ignored. 

file.o object file 

a. out assembler output 

/tmp/ctm? temporary 

/usr/lib/cpp C macro preprocessor 

/usr/Ub/asG symbolic to binary assembly language translator 

/usr/lib/asl binary assembly language assembler and reorganizer 

/usr/include standard directory for *#ijiclude'' files 

SEE ALSO 

Assembly Language Programmer's Guide 
cc(l), asO(l), what(l) 

DIAGNOSTICS 

The diagnostics produced by the assembler are intended to be self-explanatory. 



( 
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NAME 

at - execute commands at a later time 

SYNOPSIS 

at [ ^c ] [ -s ] [ -m ] time [ day ] [ file ] 

DESCRIPTION 

at spools away a copy of the named file to be used as input to sh{V) or csh{l). If the -c flag 
(for (csh{l))) or the -s flag (for (sh{l))) is specified, then that shell will be used to execute 
the job; if no shell is specified, the current environment shell is used. If no file name is 
specified, at prompts for commands from standard input until a "D is typed. 

If the — m flag is specified, mail will be sent to the user after the job has been run. H errors 
occur during execution of the job, then a copy of the error diagnostics will be sent to the user. 
If no errors occur, then a short message is sent informing the user that no errors occurred. 

The format of the spool file is as follows: A four line header that includes the owner of the 
job, the name of the job, the shell used to run the job, and whether mail will be set after the 
job is executed. The header is followed by a cd command to the current directory and a 
umask command to set the modes on any files created by the job. Then at copies all relevant 
environment variables to the spool file. When the script is run, it uses the user and group DD 
of the creator of the spool file. 

The time is 1 to 4 digits, with an optional following *A', *F, 'N' or 'M' for AM, PM, noon or 
midnight. One and two digit numbers are taken to be hours, three and four digits to be hours 
and minutes. If no letters follow the digits, a 24 hour clock time is understood. 

The optional day is either (1) a month name followed by a day number, or (2) a day of the 
week; if the word 'week' follows, invocation is moved seven days further off. Names of 
months and days may be recognizably truncated. Examples of legitimate commands are 

at Sam jan 24 

at -c -m 1530 fr week 

at -s -m 1200n week 

at programs are executed by periodic execution of the command /usr/lib/atrun from cron{S). 
The granularity of at depends upon the how often atrun is executed. 

Error output is lost unless redirected or the —m flag is requested, in which case a copy of the 
errors is sent to the user via mail{V), 

FILES 

/usr/spool/at spooling area 

/usr/spool/at/yy.ddd.hhhh.* job file 

/usr/spool/at/past directory where jobs are executed from 

/usr/spool/at/lasttimedone last time atrun was run 
/usr/lib/atrun executor (run by cron(8)) 

SEE ALSO 

atl(l), atq(l), atrm(l), calendar(l), sleep(l), cron(8), 

DIAGNOSTICS 

Complains about various syntax errors and times out of range. 



BUGS 



Due to the granularity of the execution of /usr/lib/atrun, there may be bugs in scheduling 
things almost exactly 24 hours into the future. 

If the system crashes, mail is not sent to the user informing them that the job was not com- 
pleted. 
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Sometimes old spool files are not removed from the directory /usr/spool/at/past. This is usu- \ 

ally due to a system crash, and requires that they be removed by hand. 
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NAME 

atl - list a job waiting to be run 

SYNOPSIS 

atl /(?&#... 

DESCRIPTION 

ad lists on stdout the contents of the job# which is waiting to be run at a later date. These 
jobs were created with the at{l) command. To obtain the needed job#, the user should use 
the a/^(l) command. 

Only the job's owner (or root) may list the contents of the job. 

FILES 

/usr/spool/at spool area 

AUTHOR 

Roger Southwick (rogers@dadla.TEK.COM) 

SEE ALSO 

at(l), atq(l), atrm(l), cron(8). 
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NAME 

atq - print the queue of jobs waiting to be run 

SYNOPSIS 

atq [ -c ] [ -n ] [ name ... ] 

DESCRIPTION 

atq prints the queue of jobs that are waiting to be run at a later date. These jobs were created 
with the flf(l) command. With no flags, the queue is sorted in the order that the jobs will be 
executed." 

If the -^c flag is used, the qiieue is sorted by th^ time that the at command was given. 

The ^n flag prints only the tqtal number of files that are currently in the queue. 

If a name(s) is provided, only those files belonging to that user(s) are displayed. 

FILES 

/usr/spool/at spool area 

SEE ALSO 

at(l), atl(l), atrm(l), cron(8). 
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NAME 

atrni - remove jobs spooled by at 

SYNOPSIS 

atrm [ -f ][ -i ] H [[ job #][ name]...] 

DESCRIPTION 

atrm removes jobs that were created with the at{i) command. With the — flag, all jobs 
belonging to the person invoking atrm are removed. If a job numb^r(s) is specified, atrm 
attempts to remove only that job number(s). 

If the '-f flag is used, all information regarding the removal of the specified jobs is suppressed. 
If the ^i flag is used, atrm asks if a job should be removed; a response of 'y' causes the job to 
be removed. 

If a user(s) name is specified, all jobs belonging to that user(s) are removed. This form of 
invoking atrm is useful only to the super-user. 

FILES 

/usr/spool/at spool area 

SEE ALSO 

at(l), atl(l), atq(l), cron(8). 
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NAME 

awk - pattern scanning and processing language 

SYNOPSIS 

awk [ — Fc ] [ prog ][ file ] ... 

DESCRIPTION 

awk scans each input /i/e for lines that match any of a set of patterns specified mprog. With 
each pattern in /?rog there can be an associated action that will be performed when a line of a 
file matches the pattern. The set of patterns may appear literally as prog, or in a file specified 
as 'affile. 

Files are read in order; if there are no files, the standard input is read. The file name '-' 
means the standard input. Each line is matched against the pattern portion of every pattern- 
action statement; the associated action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default can be changed by 
using FS, vide infra) The fields are denoted $1, $2, .,. ; $0 refers to the entire line, 

A pattern-action statement has the form 

pattern { action } 

A missing { action } means print the line; a missing pattern always matches. 

An action is a sequence of statements. A. statement can be one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] ... } 

variable ~ expression 

print [ expression-list ] [ > expression ] 

printf format [ , expression-list ] [ > expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, newlines or right braces. An empty expression-list 
stands for the whole line. Expressions take on string or numeric values as appropriate, and 
are built using the operators +, -, *, /, %, and concatenation (indicated by a blank). The C 
operators ++, -~, +==, -=, *=, /-, and %== are also available in expressions. Variables maybe 
scalars, array elements (denoted x[i]) or fields. Variables are initialized to the null string. 
Array subscripts may be any string, not necessarily numeric; this allows for a form of associa- 
tive memory. String constants are quoted "...". 

The print statement prints its arguments on the standard output (or on a file if >file is 
present), separated by the current output field separator, and terminated by the output record 
separator. The printf statement formats its expression list according to the format (see 
printf {3S)). 

The built-in function length returjis the length of its argument taken as a string, or of the 
whole line if no argument. There are also built-in functions exp, log, sqrt, and int. The last 
truncates its argument to an integer. substr(s, m, n) returns the n -character substring of s that 
begins at position m. The function sprintf(fmt, expr, expr, ,.,) formats the expressions accord- 
ing to the printf {3S) format given by fmt and returns the resulting string. 

Patterns are arbitrary Boolean combinations (!, ||, &&, and parentheses) of regular expres- ^ 

sions and relational expressions. Regular expressions must be surrounded by slashes and are i 

as in egrep. Isolated regular expressions in a pattern apply to the entire line. Regular 
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expressions may also occur in relational expressions, 

A pattern may consist of two patterns separated by a comma; in this case, the action is per- 
formed for all lines between an occurrence of the first pattern and the next occurrence of the 
second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either ~ (for con- 
tains) or !^ (for does not contain). A conditional is an arithmetic expression, a relational 
expression, or a Boolean combination of these, 

The special patterns BEGIN and END may be used to capture control before the first input 
line is read and after the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by starting the program with 

BEGIN{FS = V'} 

or by using the — Fc option. 

Other variable names with special meanings include NF, the number of fields in the current 
record; NR, the ordinal number of the current record; FILENAME, the name of the current 
input file; OFS, the output field separator (default blank); ORS, the output record separator 
(default newline); and OFMT, the output format for numbers (default "%.6g"). 

EXAMPLES 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
Print all lines between start/stop pairs: 

/start/, /stop/ 
Print all lines whose first field is different from previous one: 

$1 !== prev { print; prev = $1 } 

SEE ALSO 

lex(l), sed(l) 

A. V. Aho, B. W. Kemighan, P. J. Weinberger, awk - a pattern scanning and processing 

language 



BUGS 



There are no explicit conversions between numbers and strings. To force an expression to be 
treated as a number add to it; to force it to be treated as a string concatenate "" to it. 
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NAME 

cat - catenate and print 

SYNOPSIS 

cat [ --U ] [ ^n ] [ --b ] [ ^. ] [ -y ] [ ^e ] [ »^t ] [file ... ] 

DESCRIPTION 

cat reads each/z/e in sequence and displays it on the standard output. Thus 

cat file 
displays the file on the standard output, and 

cat filel flle2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument '-' is encountered, cat reads from the standard 
input file. Output is buffered in the block size recommended by stat{2) unless the standard 
output is a terminal, when it is line buffered. The "^u option makes the output completely 
unbuffered. 

The '^n option displays the output lines preceded by lines numbers, numbered sequentially 
from 1. The -^b option numbers Unes like '^n, but omits the line numbers from blank lines. 

The -s option crushes out multiple adjacent empty lines so that the output is displayed single 
spaced. 

The -^v option displays non-printing characters so that they are visible. Control characters 
print like '^X for control-x; the delete character (octal 0177) prints as "?. Non-ascii characters 
(with the high bit set) are printed as M- (for meta) followed by the character of the low 7 bits. 
The -^e is the same as the -^v option, but in addition displays a '$' character at the end of 
each line. The -^t is the same as the -^v option, but in addition displays tab characters as '^I. 

SEE ALSO 

cp(l), ex(l), more(l), pr(l), tail(l) 

BUGS 

Beware of *cat a b >a' and 'cat a b >b\ which destroy the input files before reading them. 



( 
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NAME 

CC - MIPS C compiler 

SYNOPSIS 

CC [ option ] ... file ... 

DESCRIPTION 

Cc, the MIPS ucode G compiler, produces files in the following formats: MIPS object code in 
MIPS extended c<9^ format (the normal result), binary or ^ymhoYic ucode ^ ucode object files 
and binary or symbolic assembly language. Cc accepts several types of arguments: 

Arguments whose names end with 'x' are assumed to be C source programs. They are com- 
piled, and each object program is left in the file whose name consists of the last component of 
the source with '.o' substituted for *.c'. The '.o' file is only deleted when a single source pro- 
gram is compiled and loaded all at once. 

Arguments whose names end with '.s' are assumed to be symbolic assembly language source 
programs. They are assembled, producing a *.o' file. Arguments whose names end with '.i' 
are assumed to be C source after being processed by the C preprocessor. They are compiled 
without being processed by the C preprocessor. 

If the highest level of optimization is specified (with the -03 flag) or only ucode object files 
are to be produced (with the --j flag) each C source file is compiled into a ucode object file. 
The ucode object file is left in a file whose name consists of the last component of the source 
with '.u' substituted for *.c'. 

The suffixes described below primarily aid compiler development and are not generally used. 
Arguments whose names end with ^B', '.O', *.S', and '.M' are assumed to be binary ucode, 
produced by the front end, optimizer, ucode object file splitter and ucode merger respectively. 
Arguments whose names end with MJ' are assumed to be symbolic ucode. Arguments whose 
names end with '.G' are assumed to be binary assembly language, which is produced by the 
code generator and the symbolic to binary assembler. 

Files that are assumed to be binary ucode, symbolic ucode, or binary assembly language by 
the suffix conventions are also assumed to have their corresponding symbol table in a file with 
a '.T' suffix. 

Cc always defines the C preprocessor macros mips, host_mips and unix to the C macro 
preprocessor and defines the C preprocessor macro LANGUAGE_C when a '.c' file is being 
compiled. Cc will define the C preprocessor macro LANGUAGE^ASSEMBLY when a '.s' file 
is being compiled. It also defines SYSTYPE_SYSV by default but this changes if the -systype 
name option is specified (see the description below). 

The following options are interpreted by cc(l). See M(l) for load-time options. 

— c Suppress the loading phase of the compilation and force an object file to be pro- 

duced even if only one program is compiled. 

— gO Have the compiler produce no symbol table information for symbolic debugging. 
This is the default. 

— gl Have the compiler produce additional symbol table information for accurate but lim- 
ited symbolic debugging of partially optimized code. 

-g or -g2 

Have the compiler produce additional symbol table information for full symbolic 
debugging and not do optimizations that Umit full symbolic debugging. 

— g3 Have the compiler produce additional symbol table information for full symboUc 
debugging for fully optimised code. This option makes the debugger inaccurate. 
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-^w 



Suppress warning messages, I 

"-pO Do not permit any profiling. This is the default. If loading happens, the standard 
runtime startup routine (crtl.o) is used, no profiling library is searched. 

-»pl or --p 

Set up for profiling by periodically sampling the value of the program counter. This 
option only affects the loading. When loading happens, this option replaces the stan- 
dard runtime startup routine with the profiling runtime startup routine (mcrtl.o) and 
searches the level 1 profiling library (libproflL.a). When profiling happens, the startup 
routine calls monstartup{3) and produces a file mon,out that contains execution- 
profiling data for use with the postprocessor prof{l), 

-"GO Turn off all optimizations. 

-Ol Turn on all optimizations that can be done quickly. This is the default. 

-Oor-02 

Invoke the global ucode optimizer. 

-03 Do all optimizations, including global register allocation. This option must precede 
all source file arguments. With this option, a ucode object file is created for each C 
source file and left in a '.u^ file. The newly created ucode object files, the ucode 
object files specified on the command line and the runtime startup routine and all the 
runtime libraries are ucode linked. Optimization is done on the resulting ucode 
linked file and then it is linked as normal producing an "a.out" file. No resulting '.o' 
file is left from the licode linked result as in previous releases. In fact -c can no 
longer be specified with -03; 

—feedback J?/e 

Used with the -cord option to specify file to be used as a feedback file. This file is 
produced by prof{l) with its -feedback option from an execution of the program 
produced by p;xi!e(l). 

•-cord Run the procedure-rearranger, cord{l); on the resulting file after Unking. The rear- 
rangement is done to reduce the cache conflicts of the program's text. The output of 
cord(l) is left in the file specified by the ■-'o output option or -a.out' by default. At 
least one —feedback /i/^ must be specified, 

-j Compile the specified source programs, and leave the ucode object file output in 

corresponding files suffixed with *.u\ 

--ko output 

Name the output file created by the ucode loader as output. This file is not removed. 
If this file is compiled, the object file is left in a file whose name consists of output 
with the suffix changed to a '.o'. K output has no suffix, a/.o' suffix: is appended to 
output. 

Pass options that start with a -k to the ucode loader. This option is used to specify 
ucode libraries (with -kk ) and other ucode loader options. 

Compile the specified source programs and leave the symbolic assembly language out- 
put in corresponding filessuffixed with \s\ 

Run only the C macro preprocessor and put the result for each source file (by suffix 
convention, i.e. ^c' and \s') in a corresponding \i' file. The *.i' file has no '#' lines 
in it. This sets the --cpp option. 

-E Run only the C macro preprocessor on the files (regardless of any suffbc or not), and 
send the result to the standard output. This sets the -^cpp option. 

— o output 






( 



( 
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Name the final output file output. If this option is used, the file 'a.out' is undis- 
turbed. 

-^Dname-def 
•^Dname 

Define the name to the C macro preprocessor, as if by *#define\ If no definition is 

given, the name is defined as "1". 

'^Vname 

Remove any initial definition of name. 

-Irf/r '#include' files whose names do not begin with V are always sought first in the direc- 
tory of the file argument, then in directories specified in —I options, and finally in the 
standard directory (/usr/include). 

—I This option will cause '#include' files never to be searched for in the standard direc- 

tory (/usr/include). 

-G num 

Specify the maximum size, in bytes, of a data item that is to be accessed from the 
global pointer. Num is assumed to be a decimal number. If num is zero, no data is 
accessed from the global pointer. The default value for num is 8 bytes. 

-v Print the passes as they execute with their arguments and their input and output files. 

^V Print the version of the driver and. the versions of all passes. This is done with the 
what(.i) command. 

-std Have the compiler produce warnings for things that are not standard in the language. 

-cpp Run the C macro preprocessor on C and assembly source files before compiling. 
This is the default for cc(l). 

— nocpp 

Do not run the C macro preprocessor on C and assembly source files before compil- 
ing. 

■^Olimit num 

Specify the maximum size, in basic blocks, of a routine that will be optimized by the 
global optimizer. If a routine has more than this number of basic blocks it will not 
be optimized and a message will be printed. An option specifying that the global 
optimizer is to be run (-O, — 02, or -03) must also be specified, Num is assumed 
to be a decimal number. The default value for num is 500 basic blocks. 

Either object file target byte ordering can be produced by cc. The default target byte ordering 
matches the machine where the compiler is running. The options — EB and —EL specify the 
target byte ordering (big-endian and little-endian, respectively). The compiler also defines a C 
preprocessor macro for the target byte ordering. These C preprocessor macros are MIPSEB 
and MIPSEL for big-endian and little-endian byte ordering respectively. 

If the specified target byte ordering does not match the machiae where the compiler is run- 
ning, then the runtime startups and libraries come from /usr/libeb for big-endian runtimes on 
a little-endian machine and from /usr/libel for little-endian runtimes on a big-endian machine. 

— EB Produce object files targeted for big-endian byte ordering. The C preprocessor macro 
MIPSEB is defined by the compiler. 

—EL Produce object files targeted for little-endian byte ordering. The C preprocessor 
macro MIPSEL is defined by the compiler. 

The following options are specific to cc : 

—signed 
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Cause all char declarations to be signed char declarations, the default is to treat them i 

as unsigned char declarations. 

•^volatile 

Causes all variables to be treated as volatile. 

— varargs 

Prints warnings for lines that may require the varargs.h macros. 

•-float Cause the compiler to never promote expressions of ty^o. float to type double. 

The option described below is primarily used to provide UNIX compilation environments 
other than the native compilation environment. 

--"systype name 

Use the named compilation environment name. See compilation (7) for the compila- 
tion environments that are supported and their names. This has the effect of changing 
the standard directory for *#include' files, the runtime libraries and where runtime 
libraries are searched for. The new items are located in their usual paths but with 
/name prepended to their/ paths. Also a preprocessor macro of the form 
SYSTYPE^WAME (with name capitaUzed) is defined in place of the default 
SYSTYPE_SYSV/ 

The options described below primarily aid compiler development and are not generally used: 

—He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ fjusmoca ]. It selects the compiler pass in tho 
same way as the --t option. If this option is used, the symbol table file produced and 
used by the passes, is the last component of the source file with the suffix changed to 
'.P and is not removed. 



( 



—K Build and use intermediate file names with the last component of the source file's 
name replacing its suffix with the conventional suffix for the type of file (for example 
'.B' file for binary wco^ie, produced by the front end). These intermediate files are 
never removed even when a pass encounters a fatal error. When ucode linking is per- 
formed and the -K option is specified the base name of the files created after the 
ucode link is ^u.ouf by default. If -ko output is specified, the base name of the 
object file is output without the suffix if it exists or suffixes are appended to output if it 
has no suffix. 

--# Converts binary ucode files (\B') or optimized binary ucode files (^0') to symbolic 
ucode (a '.U' file) using btou(l). If a symbolic ucode file is to be produced by con- 
verting the binary ucode from the C compiler front end then the front end option 
•--Xu is used instead of i?tou(l). 

'^yVc[c,..J,argl[,arg2...J 

Pass the argument[s] argi to the compiler pass[es] c[c,J, The c'^ are one of [ pfjosmo« 
cablyz ], The c's selects the compiler pass in the same way as the — t option. 

The options •--t[hpfjusmocablyzmt], '^hpath, and '■^Bstring select a name to use for a particu- 
lar pass, startup routine, or standard library. These arguments are processed from left to right 
so their order is significant. When the — B option is encountered, the selection of names 
takes place using the last "-h and — t options. Therefore, the --B option is always required 
when using —h or — t. Sets of these options can be used to select any combination of names. 

The -EB or —EL options, the --pLOl] options and the "^systype option must precede all -^B 
options because they can affect the location of runtimes and what runtimes are used. 

--'t[hpfjusmocablyzrnt] 

Select the names. The names selected are those designated by the characters follow- i 

ing the -^t option according to the following table: ^ 
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Name Character 


include 


h (see note below) 


Qpp 


P 


ccom 


f 


ujoin 


J 


uld 


u 


usplit 


s 


umerge 


m 


uopt 


o 


ugen 


c 


asO 


a 


asl 


b 


Id 


1 


ftoc 


y 


cord 


z 


[m]crt[ln].o 


r 


libprofl.a 


n 


btou, utob 


t 



If the character 'h' is in the — t argument then a directory is added to the list of direc- 
tories to be used in searching for '#include' files. This directory name has the form 
COMP_TARGET.ROOT/usr/include^m>i^ . This directory is to contain the include files 
for the string release of the compiler. The standard directory is still searched. 

'--hpath 

Use path rather than the directory where the name is normally found. 

'-Bstring 

Appeiid string to all names specified by the — t option. If no —t option has been pro- 
cessed before the — B, the — t option is assumed to be "hpfjusmocablyzmt". This list 
designates all names. If no — t argument has been processed before the —B then a 
-^Bstring is passed to the loader to use with its -"Lc arguments. 

Invoking the compiler with a name of the form ccstring has the same effect as using a --Bstring 
option on the command line. 

If the environment variable COMP_HOST_ROOT is set, the value is used as the root directory 
for all pass names rather than the default /. If the environment variable 
COMP_TARGET_ROOT is set, the value is used as the root directory for all include and library 
names rather than the default /• This affects the standard directory for *#include' files, 
/usr/in elude, and the standard library, /usr/lib/libc.a. If this is set, the first directory that is 
searched for libraries, using the -k option, is COMP_TARGET_ROOT/usr/lib/cmplrs/cc. The 
standard directories for libraries are then searched, see ld{l). 

If the environment variable TMPDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ . 

If the environment variable RLSJ[D_OBJECT is set, the value is used as the name of an object 
to link in if a link takes place. This is used to add release identification information to 
objects. It is always the last object specified to the loader. See rlsJd(l) for the tools to 
create this information. 

Other arguments are assumed to be either loader options or C-compatible object files, typi- 
cally produced by an earlier cc run, or perhaps libraries of C-compatible routines. These files, 
together with the results of any compilations specified, are loaded in the order given, produc- 
ing an executable program with the default name a.out. 
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FILES 1^ 

file.c input file 

file.o object file 

a. out loaded output 

/tmp/ctm? temporary 

/usr/lib/cpp C macro preprocessor 

/usr/lib/ccom C front end 

/usr/lib/ujoin binary ucode and symbol table joiner 

/usr/bin/uld ucode loader 

/usr/lib/usplit binaiy ucode and symbol table splitter 

/usr/lib/umerge procedure intergrator 

/usr/lib/uopt optional global ucode optimizer 

/usr/lib/ugen code generator 

/usr/lib/asO symbolic to binary assembly language translator 

/usr/lib/asl binary assembly language assembler and reorganizer 

/usr/lib/crtl»o runtime startup 

/usr/lib/crtn.o runtime startup 

/usr/lib/mcrtl.o startup for profiling 

/usr/lib/libc.a standard library, see in/ro (3) 
/usr/lib/libprofl.a level 1 profiling library 

/usr/include standard directory for *#include' files 

/usr/bin/ld MIPS loader 

/usr/lib/ftoc interface between prof {I) and cord{l) 

/usr/lib/cord procedure-rearranger 

/usr/bin/btou binary to symbolic ucode translator 

/usr/bin/utob symbolic to binary ucode translator | 

mon.out file produced for analysis by pr<?/(l) ^ 

Runtime startups and libraries for the opposite byte sex of machine the compiler is running on 
have the same names but are located in different directories. For big-endian runtimes on a 
little-endian machine the directory is /usr/libeb and for little-endian runtimes on a big-endian 
machine the directory is /usr/libeL 

SEE ALSO 

B. W. Kemighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 

B.V^.Kemi^han, Programming in C--a tutorial 

D. M, Ritchie^ C Reference Manual 

Languages Programmer's Guide 

monstartup(3), prof(l), ld(l), dbx(l), what(l), cord(l), pixie(l), ftoc(l) 

DIAGNOSTICS 

The diagnostics produced by cc are intended to be self-explanatory. Occasional messages may 
be produced by the assembler or loader. 



NOTES 



The standard library, /usr/lib/libc.a, i$ loaded by using the 4c loader option and not a full 
path name. The wrong one Qould be loaded if there are files with the name lihc. s^tring in the 
directories specified with the -L loader option or in the default directories searched by the 
loader. 

The handling of include directories and libc.a is confusing. 



( 
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NAME 

checknr - check nroff/troff files 

SYNOPSIS 

checknr [ ""s ] [ —f ] [ — a.xl.yl.x2.y2. ... .xn.yn ] [ — c.xl.x2.x3 ... .xn ] [file ... ] 

DESCRIPTION 

checknr checks a list of nroff{l) or troff{i) input files for certain kinds of errors involving 
mismatched opening and closing delimiters and unknown commands. If no files are specified, 
checknr checks the standard input. Delimeters checked are: 

(1) Font changes using \fx ... \fP. 

(2) Size changes using \sx ... \sO. 

(3) Macros that come in open ... close forms, for example, the .TS and .TE macros 
which must always come in pairs. 

checknr knows about the ms(7) and me (7) macro packages. 

Additional pairs of macros can be added to the list using the —a option. This must be fol- 
lowed by groups of six characters, each group defining a pair of macros. The six characters 
are a period, the first macro name, another period, and the second macro name. For exam- 
ple, to define a pair .BS and .ES, use -a.BS.ES 

The -^c option defines commands which would otherwise be complained about as undefined. 

The — f option requests checknr to ignore \f font changes. 

The —s option requests checknr to ignore \s size changes. 

checknr is intended to be used on documents that are prepared with checknr in mind, much 
the same as lint. It expects a certain document writing style for \f and \s commands, in that 
each \fa must be terminated with \fP and each \sx must be terminated with \sO. While it will 
work to directly go into the next font or explicitly specify the original font or point size, and 
many existing documents actually do this, such a practice will produce complaints from 
checknr. Since it is probably better to use the \fP and \sO forms anyway, you should think of 
this as a contribution to your document preparation style. 

SEE ALSO 

nroff(l), troff(l), checkeq(l), ms(7), me(7) 

DIAGNOSTICS 

Complaints about unmatched delimiters. 
Complaints about unrecognized commands. 
Various complaints about the syntax of commands. 



BUGS 



There is no way to define a 1 character macro name using —a. 

Does not correctly recognize certain reasonable constructs, such as conditionals. 
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name; 

chgrp - change group 

SYNOPSIS 

chgrp [ -f -R ] group file .,,.-.. 

DESCRIPTION 

.changes the group-ID of the files to group. The group may be either a decimal GID or a 
group name found in the group-ID file. 

The user invoking chgrp must belong to the specified group and be the owner of the file, or be 
the super-user. 

No errors are reported when the -«f (force) option is given. 

When the -R option is given, chgrp recursively descends its directory arguments setting the 
specified group-ID. When symbolic links are encountered, their group is changed, but they 
are not traversed. 

FILES 

/etc/group 

SEE ALSO 

chown(2), passwd(5), group(5) 



( 



( 



( 
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NAME 

chmod - change mode 

SYNOPSIS 

chmod [ — Rf ] mode file . . . 

DESCRIPTION 

The mode of each named file is changed according to mode, which may be absolute or sym- 
bolic. An absolute mode is an octal number constructed from the OR of the following 
modes: 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see c/zmorf (2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[who] op permission [op permission] ... 

The who part is a combination of the letters u (for user's permissions), g (group) and o 
(other). The letter a stands for all, or ugo. If who is omitted, the default is a but the setting 
of the file creation mask (see umask(2)) is taken into account. 

Op can be + to add permission to the file's mode, — to take away permission and ss to assign 
permission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), X (set execute 
only if file is a directory or some other execute bit is set), s (set owner or group id) and t (save 
text - sticky). Letters u, g, or o indicate that permission is to be taken from the current 
mode. Omitting permission is only useful with = to take away all permissions. 

When the — R option is given, chmod recursively descends its directory arguments setting the 
mode for each file as described above. When symbolic links are encountered, their mode is 
not changed and they are not traversed. 

If the -f option is given, chmod will not complain if it fails to change the mode on a file. 
EXAMPLES 

The first example denies write permission to others, the second makes a file executable by all 
if it is executable by anyone: 

chmod o-w file 
chmod 4-X file 

Multiple symbolic modes separated by commas may be given. Operations are performed in 
the order specified. The letter s is only useful with u or g. 

Only the owner of a file (or the super-user) may change its mode. 

SEE ALSO 

ls(l), chmod(2), stat(2), umask(2), chown(8) 
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NAME 

cobol ^ MIPS COBOL compiler 

SYNOPSIS 

cobol [ option ] ,,. file .,. 

DESCRIPTION 

Cobol, the MIPS mode cobol compiler, produces files in the following formats: MIPS object 
-code in MIPS extended cojf format (the normal result), binary or symbolic ucode, ucode 
object files and binary or symbolic assembly language. Cobol accepts several types of argu- 
ments: 

Arguments whose names end with *.cob' are assumed to be Cobol source programs. They are 
compiled, and each object program is left in the file whose name consists of the last com- 
ponent of the source with \o' substituted for '.cob'. The '.o' file is only deleted when a single 
source program is compiled and loaded all at once. 

When this command results in a call to the linker the first object the linker encounters on the 
command line will be where execution begins when the final load module is executed. 

Arguments whose names end with ^s' are assumed to be symboUc assembly language source 
programs. They are assembled, producing a ^o' file. 

The suffixes described below primarily aid compiler development and are not generally used. 
Arguments that end with MF are assumed to be a file containing LFI intermediate code opera- 
tors and its corresponding file containing the LPI intermediate code symbols is assumed to be 
in a file with a '.st' suffix. 

Arguments whose names end with \B\ '.0\ ^S^ and ',M' are assumed to be binary ucode, 
produced by the front end, optimizer, ucode object file splitter and ucode merger respectively. 
Arguments whose names end with MJ' are assumed to be symbolic ucode. Arguments whose 
names end with ^G' are assumed to be binary assembly language, which is produced by the 
code generator and the symbolic to binary assembler. 

Files that are assumed to be binary ucode, symbolic ucode, or binary assembly language by 
the suffix conventions are also assumed to have their corresponding symbol table in a file with 
a \T suffix. 

The following options are interpreted by cobol (l). See Id (I) for load-time options. 

— c Suppress the loading phase of the compilation and force an object file to be pro- 

duced even if only one program is compiled. 

-gO Have the compiler produce no symbol table information for symbolic debugging. 
This is the default. 

-gl Have the compiler produce additional symbol table information for accurate but lim- 
ited symbolic debugging of partially optimized code. 

-gor-«g2 

Have the compiler produce additional symbol table information for full symbolic 
debugging and not do optimizations that limit full symbolic debugging. 

-g3 Have the compiler produce additional symbol table information for full symbolic 
debugging for fully optimized code. This option makes the debugger inaccurate. 

-w Suppress warning messages (level 1 (INFORMATIONAL) error messages). 

-pO Do not permit any profiling. This is the default. If loading happens, the standard ^ 

runtime startup routine (crtl.o) is used, no profiling library is searched. f 
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—pi or -p 

Set up for profiling by periodically sampling the value of the program counter. This 
option only affects the loading. When loading happens, this option replaces the stan- 
dard runtime startup routine with the profiling runtime startup routine (mcrtl.o) and 
searches the level 1 profiling library (libprofl.a). When profiling happens, the startup 
routine calls monstartup(3) and produces a file mon,out that contains execution- 
profiling data for use with the postprocessor prof{l), 

"-OO Turn off all optimizations. 

'^Ol Turn on all optimizations that can be done quickly. This is the default. 

-O or -OZ 

Invoke the global ucode optimizer. 

•^feedback jft/e 

Used with the -cord option to specify file to be used as a feedback file. This file is 
produced by prof{l) with its —feedback option from an execution of the program 
produced by pixie (1) . 

—cord Run the procedure-rearranger, cord{l), on the resulting file after linking. The rear- 
rangement is done to reduce the cache conflicts of the program's text. The output of 
cord{l) is left in the file specified by the — o output. option or 'a.out' by default. At 
least one -feedback /iZe must be specified. 

— j Compile the specified source programs, and leave the ucode object file output in 

corresponding files suffixed with *.u'. 

— ko output 

Name the output file created by the ucode loader as output. This file is not removed. 
If this file is compiled, the object file is left in a file whose name consists of output 
with the suffix changed to a '.o'. If output has no suffix, a *.o' suffix is appended to 
output, 

— k Pass options that start with a — k to the ucode loader. This option is used to specify 

ucode libraries (with — kU ) and other ucode loader options. 

— S Compile the specified source programs and leave the symboUc assembly language out- 

put in corresponding files suffixed with *.s'. 

— o output 

Name the final output file output. If this option is used, the file *a.out' is undis- 
turbed. 

— G/zwm 

Specify the maximum size, in bytes, of a data item that is to be accessed from the 
global pointer. Num is assumed to be a decimal number. If num is zero, no data is 
accessed from the global pointer. The default value for num is 8 bytes. 

—V Print the passes as they execute with their arguments and their input and output files. 

—V Print the version of the driver and the versions of all passes. This is done with the 
what(l) command. 

— Olimit num 

Specify the maximum size, in basic blocks, of a routine that will be optimized by the 
global optimizer. If a routine has more than this number of basic blocks it will not 
be optimized and a message will be printed. An option specifying that the global 
optimizer is to be run (-0, -02, or — 03) must also be specified. Num is assumed 
to be a decimal number. The default value for num is 500 basic blocks. 
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Either object file target byte ordering can be produced by coboL The default target byte ord- 
ering matches the machine where the compiler is running. The options -"EB and --EL specify 
the target byte ordering (big-endian and little-endian, respectively). 

If the specified target byte ordering does not match the machine where the compiler is run- 
ning, then the runtime startups and libraries come from /usr/libeb for big-endian runtimes on 
a little-endian machine and from /usr/libel for little-endian runtimes on a big-endian machine. 

— EB Produce object files targeted for big-endian byte ordering. 

"-EL Produce object files targeted for little-endian byte ordering. 

The following options are specific to cobol : 

—defext 

Allows the use of external data. This is required in programs where external data are 
defined. 

— dline Compiles all source lines having a 'D' in the indicator area (column 7). If this option 
is not specified, all source lines with a *D' in the indicator area are treated as comment 
lines. 

"-f n Flags all items in the source program that exceed the Federal Information Processing 
Standard (FIPS) Level specified by n, where n stands for one of the following: 

1 FIPS Low Level 

2 FIPS Low-Intermediate Level 

3 FIPS High-Intermediate Level 

4 FIPS High Level 

--"fsc74 Turns off the default ANSI-85 status codes and generates ANSI-74 status codes. 

-"■1 [listing] 

Produces a compiler listing file with a suffix M'. If listing is specified, the listing file is 
named by it. This option is only recognized by the cobol front-end; it must be used in 
conjunction with the -Wf option. 

— supp_cob85 

Removes the additional ANSI-85 reserved words from the compiler's reserved word 
table, freeing them for use as user names. 

■™supp_cod 

Removes the supplemental CODASYL reserved words from the compiler's reserved 
word table, freeing them for use as user names. 

— compjrunc 

Truncates values in COMPUTATIONAL data items. 

-ansi Turns off the extensions to the ACCEPT and DISPLAY statements. 

— Ipilock 

Specifies LPI record locking. 

^nolock 

Suppresses record locking. - 

The option described below is primarily used to provide UNIX compilation environments 
other than the native compilation environment. 
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— systype name 

Use the named compilation environment name. See compilation (1) for the compila- 
tion environments that are supported and their names. This has the effect of changing 
the standard directory for *#include' files, the runtime libraries and where runtime 
libraries are searched for. The new items are located in their usual paths but with 
I name prepended to their paths. 

The options described below primarily aid compiler development and are not generally used: 

—He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ fkjusmoca ]. It selects the compiler pass in the 
same way as the — t option. If this option is used, the symbol table file produced and 
used by the passes, is the last component of the source file with the suffix changed to 
*.T' and is not removed. 

— K Build and use intermediate file names with the last component of the source file's 
name replacing its suffix with the conventional suffix for the type of file (for example 
*.B' file for binary ucode, produced by the front end). These intermediate files are 
never removed, even when a pass encounters a fatal error. When ucode Unking is per- 
formed and the — K option is specified the base name of the files created after the 
ucode link is *u.out' by default. If — ko output is specified, the base name of the 
-object file is output without the suffix if it exists or suffixes are appended to output if it 
has no suffix. 

— # Converts binary ucode files (*.B') or optimized binary ucode files (*.0') to symbolic 
ucode (a MJ' file) using btou{l). 

-yVc[c...],argl[,arg2...] 

Pass the argument[s] argi to the compiler pass[es] c[c..]. The c's are one of [ flcjusmo- 
cablyz ]. The c's selects the compiler pass in the same way as the —t option. 

The options — t[fkjusmocablyzrCS01EMnt], --^hpath, and ^Bstring select a name to use for a 
particular pass, startup routine, or standard library. These arguments are processed from left 
to right so their order is significant. When the — B option is encountered, the selection of 
names takes place using the last — h and — t options. Therefore, the — B option is always 
required when using —h or — t. Sets of these options can be used to select any combination of 
names. 

The — EB or —EL options, the — p[01] options and the —systype option must precede all — B 
options because they can affect the location of runtimes and what runtimes are used. 

-t[fkjusmocablyzrCS01EMnt] 

Select the names. The names selected are those designated by the characters follow- 
ing the — t option according to the following table: 
Name Character 
cobfe f 

ulpi k 

ujoin j 

uld u 

usplit s 

umerge m 

uopt o 

ugen c 

asO a 

asl b 

Id 1 

ftoq y 
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Use path rather than the directory where the name is normally found. 
"^Bstring 

Append string to all names jspecified by the -t option. If no -^t option has been pro- 
cessed before the -B, the ^t option is assumed to be "fkjusmocablyzrCSOlEMnt''. 
This list designates all names. If no -t argument has been processed before the -B 
then a '^Bstring is passed to the loader to use with its '^hc arguments. 

Invoking the compiler with a name of the form coholstring has the same effect as using a 
"-B^mng option on the command line. 

If the environment variable COMP^HOST^ROOT is iset, the value is used as the root directory 
for all pass names rather than the default /, If the environment variable 
COMP^TARGET^ROOT is set, the value is used as the root directory for library names rather 
than the default /, This affects the standard library, /usr/lib/libca. If this is set, the first 
directory that is searched for libraries, using the -Ix option, is ^ 

COMP_TARGET_ROQT/usi'/lib/Qpiplrs/cc. The standard directories for libraries are then \ 

searched, see ld{i). 

If the environment variable TMPDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ . 

If the environment variable RLSJD^OBJECT is set, the value is used as the name of an object 
to link in if a link takes place. This is used to add release identification information to 
objects. It is always the last object specified to the loader. See rlsJd{l) for the tools to 
create this information. 

Other arguments are assumed to be either loader options or cofeo/ -compatible object files, typ- 
ically produced by an earlier cobol run, or perhaps libraries of c(?&o/-cbmpatible routines. 
These files, together with the results of any compilations specified, are loaded in the order 
given, producing an executable program with the default name ^.out. 

file.cob input file 

file.o object file 

a. out loaded output 

/tmp/ctm? temporary 

/usr/lib/cobfe Cobol front end 

/usr/lib/ulpi LPI intermediate code to ucode translator 

/usr/lib/ujoin binary ucode and symbol table joiner 

/usr/bin/uld ucode loader 

/usr/lib/usplit binary ucode and symbol table spMtter 

/usr/lib/umerge procedure integrator 

/usr/lib/uQpt optional global ucode optimizer g- 

/usr/lib/ugen code generator I 
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/usr/lib/asO 

/usr/lib/asl 

/usr/lib/crtl.o 

/usr/lib/crtn.o 

/usr/lib/mcrtl.o 

/usr/lib/libc.a 



symbolic to binary assembly language translator 

binary assembly language assembler and reorganizer 

runtime startup 

runtime startup 

startup for profiling 

standard library, see intro (3) 
/usr/lib/libtermcap.a terminal capabilities library, sqg termcap(3X) 
/usr/lib/libprofl,a level 1 profiling library 

Cobol library 

Sort library 

Indexed sequential access method library 

PL/I library 

exception library 

math library 

MIPS loader 

interface between prof(l) and cord{V) 

pro cedure-rearranger 

binary to symbolic ucode translator 

symbolic to binary ucode translator 

file produced for analysis by prof (I) 

Runtime startups and libraries for the opposite byte sex of machine the compiler is running on 
have the same nanles but are located in different directories. For big-endian runtimes on a 
little-endian machine the directory is /usr/libeb and for little-endian runtimes on a big-endian 
machine the directory is /usr/libel. 

SEE ALSO 

monstartup(3), prof(l), ld(l), dbx(l), what(l), cord(l), pixie(l), ftoc(l) 

DLiGNOSTICS 

The diagnostics produced by cobol are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. 



/usr/lib/libcob.a 

/usr/lib/libsort.a 

/usr/lib/libisam,a 

/usr/lib/libpU.a 

/usr/lib/libexc.a 

/usr/lib/libm.a 

/usr/bin/ld 

/usr/lib/ftoc 

/usr/lib/cord 

/usr/bin/btou 

/usr/bin/utob 

mon.out 



NOTES 



The standard library, /usr/lib/libc.a, and the terminal capabilities library, 
/usr/lib/libtermcap.a, are loaded by using the -Ic and -Itermcap loader options and not full 
path names. The wrong ones could be loaded if there are files with the name lihc, astring or 
libtermcap.aym'ng in the directories specified with the -L loader option or in the default 
directories searched by the loader. 

The handling of libc.a is confusing. 
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NAME 

col - filter reverse line feeds 

SYNOPSIS 

col [ -bfh ] 

DESCRIPTION 

col reads the standard input and writes the standard output. It performs the line overlays 
impUed by reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds 
(ESC-9 and ESC-S). col is particularly useful for filtering multicolumn output made with the 
\Tf command of nroff and output resulting from use of the tbl(l) preprocessor. 

Although col accepts half line motions in its input, it normally does not emit them on output. 
Instead, text that would appear between lines is moved to the next lower full line boundary. 
This treatment can be suppressed by the -^f (fine) option; in this case the output from col may 
contain forward half Une feeds (ESC-9), but will still never contain either kind of reverse line 
motion. 

If the '^b option is given, col assumes that the output device in use is not capable of back- 
spacing. In this case, if several characters are to appear in the same place, only the last one 
read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text 
in an alternate character set. The character set (primary or alternate) associated with each 
printing character read is remembered; on output, SO and SI characters are generated where 
necessary to maintain the correct treatment of each character. 

If the -h option is given, col converts white space to tabs to shorten printing time. 

All control characters are removed from the input except space, backspace, tab, return, new- 
line, ESC (033) followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an 
alternate form of full reverse Une feed, for compatibility with some other hardware conven- 
tions. All other non-printing characters are ignored. 

SEE ALSO 

troff(l), tbl(l) 

BUGS 

Can't back up more than 128 lines. 

No niore than 800 characters, including backspaces, on a line, 
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NAME 

colcrt - filter nroff output for CRT previewing 

SYNOPSIS 

colcrt[-][«2][--b][/?/^...] 

DESCRIPTION 

colcrt provides virtual half4ine and reverse line feed sequences for terminals without such 
capability, and on which -overstriking is destructive. Half-line characters and underlining 
(changed to dashing *-') are placed on new lines in between the normal output lines. 

The optional — suppresses all underiining. It is especially useful for previewing allboxed tables 
from tbl{l). 

The option —2 causes all half-lines to be printed, effectively double spacing the output. Nor- 
mally, a minimal space output format is used which will suppress empty lines. The program 
never suppresses two consecutive empty lines, however. The —2 option is useful for sending 
output to the line printer when the output contains superscripts and subscripts which would 
otherwise be invisible. 

The option — r prevents underscores under blanks from being split across lines. As an exam- 
ple, take the text "hello_there^folks". Without -r, the text is printed as 

hello there folks 

The -^r option causes this to be printed as it was originally given. Note that this may not be 
the correct thing to do when multiple words are underlined. 

A typical use of colcrt would be 

tbl exum2.n | nroff -ms | colcrt - | more 

SEE ALSO 

nroff/troff(l), col(l), more(l), ul(l) 



BUGS 



Can't back up more than 102 lines. 

General overstriking is lost; as a special case 'f overstruck with '- or underline becomes *+'. 

Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and subscripts in documents 
which are already double-spaced. 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



COLRM ( 1-BS0 ) RISC/os Programmer's Reference COLRM ( 1-BSD ) 

NAME I 

coirm - remove columns from a file 

SYNOPSIS 

coIrm [ ^tartcol [ endcol ) ] 

DESCRIPTION 

eolrm removes iselected columns from a file. Input is taken from standard input. Output is 
sent to standard output. 

If called with one parameter the columns of each line will be removed starting with the 
specified column. If called with two parameters the columns from the first column to the last 
column will be removed. 

Column numbering starts with column 1. 

SEE ALSO 

expand(l) 
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NAME 

compress, uncompress, zcat - compress and expand data 

SYNOPSIS 

compress [ — f ] [ — v ] [ — c ] [ — b bits ] [ name ... ] 
uncompress [ ""f ] [ ~"V ] [ — c ] [ name ... ] 
zcat [ name ... ] 

DESCRIPTION 

compress reduces the size of the named files using adaptive Lempel-Ziv coding. Whenever 
possible, each file is replaced by one with the extension .Z^ while keeping the same ownership 
modes, access and modification times. If no files are specified, the standard input is 
compressed to the standard output, compressed files can be restored to their original form 
using uncompress or zcat. 

The —f option will force compression of name, even if it does aot actually shrink or the 
corresponding name.Z file already exists. Except when run in the background under Ibin/sh, 
if — f is not given the user is prompted as to whether an existing nameX file should be 
overwritten. 

The — c ("cat") option ra^k^s compress /uncompress write to the standard output; no files are 
changed. The nondestructive behavior of zcat is identical to that of uncompress -"c. 

compress uses the modified Lempel-Ziv algorithm popularized in "A Technique for High Per- 
formance Data compression", Terry A. Welch, IEEE Computer, vol. 17, no. 6 (June 1984), 
pp. 8-19. Common substrings in the file are first replaced by 9-bit codes 257 and up. When 
code 512 is reached, the algorithm switches to 10-bit codes and continues to use more bits 
until the limit specified by the — b flag is reached (default 16). Bits must be between 9 and 16. 
The default can be changed in the source to allow compress to be run on a smaller machine. 

After the bits limit is attained, compress periodically checks the compression ratio. If it is 
increasing, compress continues to use the existing code dictionary. However, if the compres- 
sion ratio decreases, compress discards the table of substrings and rebuilds it from scratch. 
This allows the algorithm to adapt to the next "block" of the file. 

Note that the —b flag is omitted for uncompress, since the bits parameter specified during 
compression is encoded within the output, along with a magic number to ensure that neither 
decompression of random data nor recompression of compressed data is attempted. 

The amount of compression obtained depends on the size of the input, the number of bits per 
code, and the distribution of common substrings. Typically, text such as source code or 
English is reduced by 50-607o. compression is generally much better than that achieved by 
Huffman coding (as used in pack), or adaptive Huffman coding {compact), and takes less time 
to compute. 

The —V option causes the printing of the percentage reduction of each file. 

If an error occurs, exit status is 1, else if the last file was not compressed because it became 
larger, the status is 2; else the status is 0. 

DIAGNOSTICS 

Usage: compress [-fvc] [-b maxbits] [file ..,] 

Invalid options were specified on the command line. 
Missing maxbits 

Maxbits must follow — b. 
file : not in compressed format 

The file specified to uncompress has not been compressed. 
file : compressed with xx bits, can only handle yy bits 

File was compressed by a program that could deal with more bits than the 
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compress code on this machine. Recompress the file with smaller M^. 1 

file: already has .Z suffix -- no change 

The file is assumed to be already compressed. Rename the file and try 

again. 
file: filename too long to tack on .Z 

The file cannot be compressed because its name is longer than 12 characters. 

Rename and try again. This message does not occur on BSD systems. 
file already exists; do you wish to overwrite (y or n)? 

Respond "y" if you want the output file to be replaced; "n" if not. 
uncompress: corrupt input 

A SIGSEGV violation was detected which usually means that the input file 

is corrupted, 
compression: xj.jk:j% 

Percentage of the input saved by compression. (Relevant only for «-v.) 

- not a regular file: unchanged 

When the input file is not a regular file, (e.g. a directory), it is left unaltered. 

- has XX other links: unchanged 

The input file has links; it is left unchanged. See ln(l) for more informa- 
tion. 

- file unchanged 

No savings is achieved by compression. The input remains virgin. 



BUGS 



Although compressed files are compatible between machines with large memory, -bl2 should 
be used for file transfer to architectures with a small process data space (64KB or less, as exhi- 
bited by the DEC PDP series, the Intel 80286, etc.) 

compress should be more flexible about the existence of the '.Z' suffix. 
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NAME 

cord - rearranges procedures in an executable file to facilitate better cache mapping. 

SYNOPSIS 

cord [-v] [-0 outfile] [-fj [-c cachesize] [-p maxphases] objjile reorder _file 

DESCRIPTION 

The cord command rearranges procedures in an exectable object file to maximize efficiency in 
a machine's cache. By rearranging the procedures properly, we end up reducing the instruc- 
tion cache miss rates. Cord does not attempt to determine the correct ordering, but is given a 
reorder file containing the desired procedure order. The reorder file is generated by the ftoc 
program, which in turn generates a reorder file from a set of profile feedback files (see 
prof(l)). 

Processed lines in the reorder file are called procedure lines. Each procedure line must be on 
a separate source line. Each procedure line must contain the source name of the file, fol- 
lowed by a blank followed by a qualified procedure name. Nested procedures must be 
qualified x.y where x is the outer procedure. A newline or blank can follow the procedure 
name: 

foo,c bar (everything else following is ignored) 

Lines beginning with # are comments, lines beginning \vith $ are considered cord directive 
lines. The only directive currently understood is $phase. This directive will consider the rest 
of the file (until the end of file or next %phase) as a new phase of the program and will order 
the procedures accordingly. A procedure may appear in more than one phase, resulting in 
more than one copy of it in the final binary. First, cord will try to relocate procedure refer- 
ences to a copy of the procedure belonging to the requesting phase; otherwise it will relocate 
the references to a random copy. 

We suggest you use the -cord option to a compiler driver like cc(l) rather than execute cord 
directly. Cord options can be specified with -WZfCordargOyCordargl,,.. . If you have to run 
cord by hand, you may want to run it once with the driver using the -v flag on a simple pro- 
gram. This will enable you to see the exact passes and the arguments involved in using cord. 

Ob] is an executable object file with its relocation information intact. This can be achieved by 
passing the -r -z -d options to the linker, ld(l). The linker option -r maintains relocation 
information in the object file, but will not make it a ZMAGIC file (hence -z). It also will not 
allocate common variables (hence -d) as it would without the option. 

WARNING: Since cord works from an input list of procedures generated from profile output, 
the resulting binary is data dependent. In other words, it may only preform well on the same 
input data that generated the profile information, and may preform worse than the original 
binary on other data. Furthermore, if the hot areas in the cache don't fit well into one 
c^chepage, performance can degrade. 

The cord command accepts these options: 

-V Print verbose information. This includes listing those procedures considered 

part of other procedures and cannot be rearranged (these are basically assem- 
bler procedures that may contain relative branches to other procedures rather 
than relocatable ones). The Usting also lists those procedures in the flipped 
area (if any) and a mapping of old location to new. 

-f Flip the first cachepage size procedures. The assumption when cord was writ- 

ten was that procedures would be reordered by procedure density 
(cycles/byte). This option ensures that the densest part of each page following 
the first cachepage would conflict with the least-dense part of the first 
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cachepage. I 

-c cachesize 

Specify the cachesize (in bytes) of the machine on which you want to execute. 
This only affects the -f option. If not specified, 65536 is used. 

-Q outputfile 

Specifies the output file. If not specified, a. out is used. 

-p phasemax 

specifies the maximum number phases allowed. The default is 20. 

SEE ALSO 

prof(l), ftoc(l), cc(l), ld(l), MIPS Languages Programmer Guide 
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NAME 

cord2 - rearranges basic blocks in an executable file to facilitate better cache mapping. 

SYNOPSIS 

cord[2 [-v] [-0 outfile] [-c cachewords] [-d] [-b bridgejimit] [-n] [-A addersfile] [[-C countsfile] 
...] obj 

DESCRIPTION 

The cord2 command extracts basic blocks from a program and deposits them in a new area in 
the text, making jumps from and to that area as necessary. By separating the basic blocks, 
you can reduce instruction cache miss rates. Cord2 takes the output of a pixie profiling run as 
input (see pa/efijj. 

Obj is an executable object file. Cord2 only requires one addersfile; it will create the filename 
by appending ,Bbaddrs to the obj filename if none is specified with -A. Many counts files can 
be specified from many runs with multiple -C arguments; if none is specified cord2 will create 
the counts filename by appending .Counts to the obj name. Multiple counts files will be added 
together into an internal counts array represented with C double-type elements. The counts 
array elements contain the density of a block or cycles/byte. If you specify -n, then the 
counts are normalized so that each counts array entry is cycles/totalcycles. When one counts is 
specified, the default is to favor small blocks; -n negates that. When many counts files are 
specified, -n also negates favoring one counts file. This is because its totalcycles may exceed 
the totalcycles of another counts file. 

Cord2 determines which basic blocks to insert by sorting the counts array and collecting the 
blocks with the highest counts that will fit into the new area. Cord2 may skip over huge blocks 
that won't fit at the end of the new area. 

Once the blocks are determined, they are inserted into the new area, and their original loca- 
tion is modified to jump to the new area. At the end of each block in the new area, a jump is 
added back to the original block's subsequent or fall-through location, and the branch/jump 
target (if necessary). Both entering and exiting the new area is optimized to take advantage of 
other blocks also in the new area, and jump delay slots. 

Many times there may be one or more fall-through blocks of a block in the new area which 
are 1) small, 2) hardly ever used, and 3) not in the new area. If the block following these fall- 
through blocks is in the new area, the fall-through blocks are called bridge blocks. It may be 
more costly to generate jumps to and from bridge blocks rather than to just copy them. 
Cord2 allows you to specify that bridge blocks be added to the new area if they total less than 
the bridgejimit instructions between two new-area blocks. You may specify the bridgejimit 
with -b; the default is zero. Bridge blocks may bump blocks out of the new area that might 
normally fit into it. 

WARNING: Since cord2 works from profile output, the resulting binary is data dependent. In 
other words, it may perform well only on the same input data that generated the profile infor- 
mation, and may perform worse than the original binary on other data. Furthermore, if the 
hot areas in the cache don't fit well into one cachepage, performance can degrade. 

The cord2 command also accepts these options: 

-d Fill the delay slots with nops only when adding jumps to and from the new 

area. 

-V Print verbose information. This includes statistics about the cord2 process. 

-V -V Print all of the -v information but include detailed dissamblies of the code 
moved, changed and generated by cord2. 

-c cachewords 

Specify the number of words in the cache of the machine on which you want 
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to execute. This will actually be the size of the new area. CacheMze may be a i 

misnomer, as you can specify a size other than your machine's cache size; 
however, it is probably the correct number. 

-o outputfile 

Specifies the output file. If not specified, a.out.cord2 is used. 

BUGS 

Cord2 adds the new area to the end of text so any program using the etext (see ld(l)) symbol 
may not work. 

SEE ALSO 

pixie(l), cord(l), MIPS Languages Programmer Guide 



( 



( 

Page 2 February 13, 1989 MIPS Computer Systems, Inc. 



CP ( 1-BSD ) RISC/os Programmer's Reference CP ( 1-BSD ) 



NAME 

cp - copy 

SYNOPSIS 

cp [ -ip ] filel file2 

cp [ — ipr ] file ... directory 

DESCRIPTION 

Filel is copied onto filel. By default, the mode and owner oi filel are preserved if it already 
existed; otherwise the mode of the source file modified by the current umask{2) is used. The 
— p option causes cp to attempt to preserve (duplicate) in its copies the modification times and 
modes of the source files, ignoring the present umask . 

In the second form, one or more files are copied into the directory with their original file- 
names. 

cp refuses to copy a file onto itself. 

If the -i option is specified, cp will prompt the user with the name of the file whenever the 
copy will cause an old file to be overwritten. An answer of 'y' will cause cp to continue. Any 
other answer will prevent it from overwriting the file. 

If the — r option is specified and any of the source files are directories, cp copies each subtree 
rooted at that name; in this case the destination must be a directory. 

SEE ALSO 

cat(l), mv(l), rcp(lC) 
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NAME 

cpp - the C language preprocessor 

SYNOPSIS 

/usr/lib/cpp [ option ,.. ] [ ifile [ ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of any C compilation 
using the cc(l) command. Thus the output of cpp is designed to be in a form acceptable as 
input to the next pass of the C compiler. As the C language evolves, cpp and the rest of the 
C compilation package will be modified to follow thes^ changes. Therefore, the use of cpp 
other than in this framework is not suggested. The preferred way to invoke cpp is through the 
cc(l) command since the functionality of cpp may someday be moved elsewhere. See m4{V) 
for a general macro processor. 

Cpp optionally accepts two file names as arguments, Ifile and ofile are respectively the input 
and output for the preprocessor. They default to standard input and standard output if not 
supplied. 

The following options to cpp are recognized: 

—P Preprocess the input without producing the line control information used by the next 
pass of the C compiler. 

•-C By default, cpp strips C-style comments. If the ---C option is specified, all comments 
(except those found on cpp directive lines) are passed along. 

•^IJname 

Remove any initial definition of name, where name is a reserved symbol that is 
predefined by the particular preprocessor. The current list of these possibly reserved 
symbols includes: None of these are defined by cpp. Instead, the compiler drivers, 
cc(l), as{l), pc(l), and /77fiJ define these symbols. 

operating system: unix, ibm, gcos, os, tss, dmert 

target hardware: mips, interdata, pdpll, u370, u3b, u3b5, u3b2, u3b20d, vax 

host hardware: host^mips 

languages: LANGUAGE^C, LANGUAGE^ SSEMBLY, 

LANGUAGE^PASCAL, LANGUAGE_FORTRAN 

UNIX system variant: RES, RT 

lmt{l): lint 

^Dname 
•^Dname—def 

Define name as if by a #define directive. If no ^def is given, name is defined as 1. 

The -D option has lower precedence than the --U option. That is, if the same name 

is used in both a -U option and a -^D option, the name will be undefined regardless 

of the order of the options. 

•^Idir Change the algorithm for searching for #mclude files whose names do not begin with 
/ to look in dir before looking in the directories on the standard list. Thus, #mciude 
files whose names are enclosed in " " will be searched for first in the directory of the 
ifile argument, then in directories named in -^I options, and last in directories on a 
standard Hst. For #include files whose names are enclosed in <>, the directory of 
the ifile argument is not searched. 

-^I This option changes the algorithm for searching for #include files to never look in the 
standard list. 

-M Print, one per line on standard output; the path names of included files. Each is ^ 

prefixed with ifile^s last component name with the suffix changed to *.o' followed by a I 
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':' and a space (for example "hello.o: /usr/in elude/ stdio.h"). 

Two special names are understood by cpp. The name LINE is defined as the current line 

number (as a decimal integer) as known by cpp, and FILE_„ is defined as the current file 

name (as a C string) as known by cpp. They can be used anywhere (including in macros) just 
as any other defined name. 

All cpp directives start with lines begun by #. The directives are: 

#define name token-string 

Replace subsequent instances of name with token-string, 

#define name( arg^ ..., arg ) token-string 

Notice that there can be no space between name and the (. Replace subsequent 
instances of name followed by a (, a list of comma separated tokens, and a ) by 
token-string where each occurrence of an arg in the token-string is replaced by the 
corresponding token in the comma separated list. When a macro with arguments is 
expanded, the arguments are placed into the expanded token-string unchanged. After 
the entire token-string has been expanded, cpp re-starts its scan for names to expand at 
the beginning of the newly created token-string. 

#undef name 

Cause the definition of name (if any) to be forgotten from now on. 

#ideiit "String" 

This directive is recognized for compatibility but ignored. 

#include "filename" 
#include <filename> 

Include at this point the contents of filename (which will then be run through cpp). 

When the <filename> notation is used, filename is only searched for in the standard 

places. See the —I option above for more detail. 

#line integer-constant "filename" 

Causes cpp to generate line control information for the next pass of the C compiler. 
Integer-constant is the line number of the next fine and filename is the file where it 
comes from. If "filename" is not given, the current file name is unchanged. 

#endif 

Ends a section of lines begun by a test directive (#if, #ifdef, or #ifndef). Each test 
directive must have a matching #endif. 

#ifdef name 

The lines following will appear in the output if and only if name has been the subject 
of a previous #define without being the subject of an intervening #undef. 

#ifndef name 

The lines following will not appear in the output if and only if name has been the sub- 
ject of a previous #define without being the subject of an intervening #uiidef. 

#if constant-expression 

Lines following will appear in the output if and only if the constant-expression evalu- 
ates to non-zero. All binary non-assignment C operators, the ?: operator, the unary 
-, !, and ~ operators are all legal in constant-expression. The precedence of the 
operators is the same as defined by the C language. There is also a unary operator 
defined, which can be used in constant-expression in these two forms: defined ( name ) 
or defined name. This allows the utility of #ifdef and #ifndef in a #if directive. Only 
these operators, integer constants, and names which are known by cpp should be used 
in constant-expression. In particular, the sizeof operator is not available. 

To test whether either of two symbols, /c?(9 andfumy are defined, use 
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#if defined(foo) II defined(fum) ■ 

#€lse Reverses the notion of the test directive which matches this directive. So if lines pre- 
vious to this directive are ignored, the following lines will appear in the output. And 
vice versa. 



The test directives and the possible #else directives can be nested. 



FH.ES 



/usr/include standard directory for #include files 

SEE ALSO 

cc(l), as(l), pc(l), f77(l), m4(l) 

DIAGNOSTICS 

The error messages produced by cpp are intended to be self-explanatory. The line number 
and filename where the error occurred are printed along with the diagnostic. 

NOTES 

When newline characters were found in argument Usts for macros to be expanded, previous 
versions of cpp put out the newlines as they were found and expanded. The current version 
of cpp replaces these newlines with blanks to alleviate problems that the previous versions had 
when this occurred. 



( 



( 



MIPS Computer Systems, Inc. February 13, 1989 Page 3 



CRYPT ( 1-BSD ) RISC/os Programmer's Reference CRYPT ( 1-BSD ) 



NAME 

crypt - encode/decode 

SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

crypt reads from the standard input and writes on the standard output. The password is a key 
that selects a particular transformation. If no password is given, crypt demands a key from the 
terminal and turns off printing while the key is being typed in. crypt encrypts and decrypts 
with the same key: 

crypt key < clear > cypher 
crypt key < cypher | pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor ed in encryption 
mode. 

The security of encrypted files depends on three factors: the fundamental method must be 
hard to solve; direct search of the key space must be infeasible; 'sneak paths' by which keys 
or cleartext can become visible must be minimized. 

crypt implements a one-rotor machine designed along the lines of the German Enigma, but 
with a 256-element rotor. Methods of attack on such machines are known, but not widely; 
moreover the amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed 
to be expensive, i.e. to take a substantial fraction of a second to compute. However, if keys 
are restricted to (say) three lower-case letters, then encrypted files can be read by expending 
only a substantial fraction of five rninutes of machine time. 

Since the key is an argument to the crypt command, it is potentially visible to users executing 
ps{l) or a derivative. To minimize this possibility, crypt takes care to destroy any record of 
the key immediately upon entry. No doubt the choice of keys and key security are the most 
vulnerable aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(8) 



BUGS 



There is no warranty of merchantability nor any warranty of fitness for a particular purpose 
nor any other warranty, either express or impHed, as to the accuracy of the enclosed materials 
or as to their suitability for any particular purpose. Accordingly, Bell Telephone Laboratories 
assumes no responsibiUty for their use by the recipient. Further, Bell Laboratories assumes 
no obligation to furnish any assistance of any kind whatsoever, or to furnish any additional 
information or documentation. 
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NAME 

date - print and set the date 

SYNOPSIS 

d^te f-nu] [-d dst] [4 timezone] [yymmddhhmm [.ss] ] 

DESCRIPTION 

If no arguments are given, the current date and time are printed. Providing an argument will 
set the desired date; only -the superuser can set the date. 

The 'd and -t flags set the kemeFs values for daylight savings time and minutes west of GMT. 
If dst is non-zero, future calls to gettim0ofday(2) will return a non-zero tzjdsttime. Timezone 
provides the number of minutes returned by future calls to getHmeofday(2) in tzm%inuteswest , 
You should also set the default timezone by using the command zic(8). Details are given in 
that manual page. 

The -u flag is used to display or set the date in GMT (universal) time, yy represents the last 
two digits of the year; the first mm is the month number; dd is the day number; hh is the hour 
number (24 hour system); the second mm is the minute number; .ss is optional and represents 
the seconds. For example: 

date 8506131627 

sets the date to June 13 1985, 4;27 PM. The year, month and day may be omitted; the default 
values will be the current ones. The system operates in GMT. date takes care of the conver- 
sion to and from local standard and daylight-saving time. 

If timed(8) is running to synchronii^e the clocks of machines in a local area network, date sets 
the time globally on all those machines unless the -n option is given* 

FILES 

/usr/adm/wtmp to record time-setting. In /usr/adm/messages, date records the name of the 
user setting the time. 

SEE ALSO 

zic(l), gettimeofday(2), utmp(5), timed(8), 

TSP: The Time Synchronization Protocol for UNIX 4JBSD, R. Gusella and S. Zatti 

DIAGNOSTICS 

Exit status is on success, 1 on complete failure to set the date, and 2 on successfully setting 
the local date but failing globally. 

Occasionally, when timed synchronizes the time on many hosts, the setting of a new time 
value may require more than a few seconds. On these occasions, date prints: 'Network time 
being set'. The message 'Communication error with timed' occurs when the communication 
between rfafe and /imed fails. 



BUGS 



The system attempts to keep the date in a format closely compatible with VMS. VMS, how- 
ever, uses local time (rather than GMT) and does not understand daylight-saving time. Thus, 
if you use both UNIX and VMS, VMS will be running on GMT. 



( 
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NAME 

dbx - source-level debugger 

SYNOPSIS 

dbx [—1 directory] [-c file] [-i] [-r] [-pixie] [object] [core] 

DESCRIPTION 

Dbx, a source-level debugger, runs under UMIPS-BSD (4.3 BSD) and UMIPS-V (V.3) versions 
of the operating system. It can handle UMIPS-V shared libraries. This enhanced version of 
dbx works with cc(l), f77(l), pc(l), as(l), and MIPS machine code. 

The object file used with the debugger is produced by specifying an appropriate option (usually 
--g ) to the compiler. The resulting object file contains symbol table information, including 
the names of all source files that the compiler translated to create the object file. These 
source files are accessible from the debugger. If — g is not specified, limited debugging is pos- 
sible. 

If a core file exists in the current directory or a coredump file is specified, dbx can be used to 
look at the state of the program when it faulted. 

Running dbx 

If a .dbxinit file resides in the current directory or in the user's home directory, the commands 
in it are executed when dbx is invoked. 

When invoked, dbx recognizes these command line options: 

•--I directory or --^Idirectory 

Tells dbx to look in the specified directory for source files. Multiple directories can 
be specified by using multiple -/ options. Dbx searches for source files in the current 
directory and in the object file's directory whether or not -/ is used. 

"^cfile Selects a command file other than ,dbxinit, 

— i Uses interactive mode. This option does not treat #s as comments in a file. It 

prompts for source even when it reads from a file. With this option, dbx also has 
extra formatting as if for a terminal. 

—r Runs the object file immediately. 

■^pixie Uses pixie output. The executable must be ^executable.pixie', and the non-pixie exe- 
cutable must be in the same directory as the pixie executable. 

—prom Permits debugging in the standalone environment when using the MIPS System 
Programmer's Package. For more information, refer to the System Programmer's 
Package Reference manual. 

—sable Permits debugging programs running under the processor simulator when the MIPS 
System Programmer's Package. 

The dbx monitor offers powerful command Une editing. For a full description of these 
emacs- style editing features, see csh(l). 

Multiple commands can be specified on the same command line by separating them with a 
semicolon (;). If the user types a string and presses the stop character (usually "z; see stty(l) 
), dbx tries to complete a symbol name from the program that matches the string. 

dbx can also run under emacs as inferior, which means under this mode, dbx is controlled by 
emacs and communicates with emacs. When in emacs, command M-x dbx starts dbx and will 
prompt you for filename to be debugged. In MIPS environment, the following keys are bound 
to commonly used dbx commands: M-n, M-s, M-i, M-u, M-d, C-c C-f, C-x space represents 
for next, step, stepi, up, down, finish, set breakpoint at current line respectively.' Note that in 
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emacs, M-x usually means esc-x^ C-x means ctl-x. In emacs you can define your own key bind- f 

ing. 

The Monitor 

These commands control the dbx monitor: 

l[string] [integer] [-integer] 

Specifies a command from the history list. 

help Prints a hst of dbx commands, using the UNIX system more command to display the 
list. 

history Prints the items from the history Hst. The default if 20. 

quit[!] Exit dbx after verification. If ! is specified, verification isn^t required. 

Controlling dbx 

alias [name(argl:f..MrgN)"string''] 

Lists all existing aliases, or, if an argument is specified, defines a new alias, 

unalias alias command jname 

Removes the specified alias, 

delete expression!, ..xxpressionN 

delete all 

Deletes the specified item from the status list. The argument all deletes all items 
from the status list. 

playback input [file] ^ 

Replays commands that were saved with the record input command in a text file. 

playback output \file] 

Replays debugger output that was saved with the record output command. 

record input [file] 

Records all commands typed to dbx, 

record output ]file] 

Records all dbx output. 

sh [shell command] 

Calls a shell from dbx or executes a shell command. 

status Lists currently set stop, record, and trace commands. 

tagyalue (tagname) 

Returns the value of tagname. If the tags extends to more than one line, or if it con- 
tains arguments, an error occurs, tagvalue can be used in any expression. 

set [variable = expression] 

Lists existing debugger variables and their values. This command can also be used to 
assign a new value to an existing variable or to define a new variable. 

unset variable 

Removes the setting of a specified debugger variable. 

Examining Source 

/regular expression 

Searches ahead in the source code for the regular expression. 

^regular expression 

Searches back in the source code for the regular expression. 
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edit Ifile] 

Calls an editor from dbx. 

file \file] Prints the current file name, or, if a file name is specified, this command changes the 
current file to the specified file. 

func [expression] [procedure] 

Moves to the specified procedure (activation level), or, if an expression or procedure 
isn't specified, prints the current activation level. 

list [expression.integer] 

list [expression] 

Lists the specified lines. The default is 10 lines. 

tag tagname 

Sets the current file/line to the location specified by tagname. Operations are similar 
to the tag operations in vi(l). 

use [directory 1 ... directory N] 

Lists source directories, or, if a directory name is specified, this command substitutes 
the new directories for the previous Ust. 

whatis variable 

Prints the type declaration for the specified name. 

which variable 

Finds the variable name currently being used. 

whereis variable 

Prints all qualifications (the scopes) of the specified variable name. 

Controlling Programs 

assign expression 1 = expression2 

Assigns the specified expression to a specified program variable. 

[n] cent [signal] 

cont [signal] to line 

cent [signal] in procedure 

Continues executing a program after a breakpoint, n breakpoints are ignored if n is 
specified before stepping; If specified, signal is delivered to the processing being 
debugged. 

goto line 

Goes to the specified line in the source. 

next [integer] 

Steps over the specified number of lines. The default is one. This command does 
not step into procedures. 

rerun [argl ... argN] [<filel][>file2] 

rerun [argl ... argN] [<filel][>&file2] 

Reruns the program, using the same arguments that were specified to the run com- 
mand. K new arguments are specified, rerun uses those arguments. 

run [argl ... argN] [<filel] [>file2] 

run [argl ... argN] [<filel] [>&file2] 

Runs the program with the specified arguments. 

return [procedure] 

Continues executing until the procedure returns. If a procedure isn't specified, dbx 
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assumes the next procedure. I 

step [integer] 

Steps the specified number of lines. This command steps into procedures. The 
defauk is one line. 

Setting Breakpoints 

catch [signal] 

Lists all signals that dbx catches, or, if an argument is specified, adds a new signal to 
the catch list. " 

ignore [signal] 

Lists all signals that dbx does not catch. If a signal is specified, this command adds 
the signal to the ignore list. 

stop [variable] 

stop [variable] skt line [if expression] 

stop [variable] in procedure [if expression] 

stop [variable] if expression 

Sets a breakpoint at the specified point. 

trace variable [at line [if expression] 

trace variable [in procedure [if expression] 
Traces the specified variable, 

when [variable] [at line] {command Jist} 

when [variable] ^n procedure] {command Jist} 

Executes the specified dhx comma separated command list. 



Examining Program State 

dump [procedure] [.] 

Prints variable information about the procedure. If a dot (.) is specified, this com- 
mand prints global variable information on all procedures in the stack and the vari- 
ables of those procedures. 

down [expression] 

Moves down the specified number of activation levels in the stack. The default is 
one level. 

up [expression] 

Moves up the specified number of activation levels on the stack. The default is one. 

print expression i, . . . expressionN 

Prints the value of the specified expression. If expression is a dbx keyword, it must 
be enclosed within parentheses. For example, to print out a variable called 'output' 
(which is also a variable in the playback and record commands) you must type: print 
(output) 

printf ''string", expression i, . . . expressionN 

Prints the value of the specified expression, using C language string formatting. As in 
the print command, if expression is a dbx keyword, you must enclose it within 
parentheses. 

printregs 

Prints all register values. 

where Does a stack trace, which shows the current activation levels. 
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where n Prints out only the top n levels of the stack. 



Debugging at the Machine Level 
[n] conti [signal] 

conti [signal] to address 

conti [signal] in procedure 

Continues executing assembly code after a breakpoint, n breakpoints are ignored if n 
is specified before stepping; If specified, signal is delivered to the processing being 
debugged. 

nexti [integer] 

Steps over the specified number of machine instructions. The default is one. This 
command does not step into procedures. 

stepi [integer] 

Steps the specified number of machine instructions. This command steps into pro- 
cedures. The default is one instruction. 

stop! [variable] at address [at address [if expression] 

stopi [variable] in procedure [if expression] 

stopi [variable] if expression 

Sets a breakpoint in the machine code at the specified point. 

tracei variable at address [at address if expression] 

tracei variable in procedure [at address if expression] 

Traces the specified variable in machine instructions. 

wheni [variable] [at address] {commandjist} 

wheni [variable] [in procedure] {commandjist} 

Executes the specified dbx comma separated command list. 

address[1]/ <co\xnt><mode> 

Searching forward (or backward, if ? is specified,) prints the contents address or 
disassembles the code for the instruction address; count is the number of items to be 
printed at the specified address, mode is one of the characters in the following table 
producing the indicated result: 

d Print a short word in decimal 

D Print a long word in decimal 

o Print a short word in octal 

O Print a long word in octal 

X Print a short word in hexadecimal 

X Print a long word in hexadecimal 

b Print a byte in octal 

c Print a byte as a character 

s Print a string of characters that ends in a null 

f Print a single precision real number 

g Print a double precision real number 

i Print machine instructions 

n Prints data in typed format. 

address/ <countL><value><mask> 

Searches for a 32-bit word starting at the specified address; count specifies the 
number of word to process in the search; an address is printed when the the word at 
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address, after an AND operation with mask, is equal to value, I 

Predefined dbx Variables 

The debugger has these predefined variables: 

$addrfmt 

Specifies the format for addresses. This can be set any specification that a G printf 
statement can format. The default is zero. 

$byteaccess 

Same as $addrfmt. 

$casesense 

When set to a nonzero value, specifies that uppercase and lowercase letters be taken 
into consideration during a search. When set to 0, the case is ignored. The default is 
0, 

$curevent 

Shows the last even number as seen in the status feature. Set only by dbx. 

$curline Specifies the current line. Set only by dbx. 

$cursrcline 

Shows the last line hsted plus 1. Set only by DBX 

$curpc Specifies the current address. Used with the wrand /r aliases. 

$datacache 

Caches information from the data space so that dbx must access data space only 
once. To debug the operating system, set this variable to 0; otherwise, set it to a 
nonzero value. The default is 1. ^^ 

$debugflag |^ 

For internal use by dbx. 

$defin For internal use by dbx. 

$defout For internal use by dto. 

$dispix For use when debugging pixie code. When set to 0, machine code is show while 
debugging. When set to 1, pixie code is shown. The default is 0. 

$hexchars 

Output characters are printed in hexadecimal format (set, unset). 

$hexin Specifies that input constants are hexadecimal. 

$hexints 

When set to a nonzero value, changes the default output constants to hexadecimal. 
Overrides $octints. 

$hexstrings 

When set to 1, specifies that all strings are printed in hexadecimal; when set to 0, 
strings are printed in character format. 

$historyevent 

Shows the current history line. 

$lines number of lines for history. The default is 20 

$listwindow 

Specifies how many fines the list command prints. 

$main Specifies the name of the procedure that d&x will start with. This can be set to any 

procedure. The default is "main" m 
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$maxstrlen 

Specifies how many characters of a string that dbx prints for pointers to strings. The 
default is 128, 

Soctin When set to non-zero, changes the default input constants to octal. When set, Shex- 
int overrides this setting. 

$octints Output integers are printed octal format (set, unset). 

$page Specifies whether to page long information. A nonzero value turns on paging; a 
turns it off. The default is 1. 

Spagewindow 

Specifies how many lines print when information runs longer than one screen. This 
can be changed to match the number of lines on any terminal. If set to 0, this vari- 
able assumes one line. The default is 22, leaving space for continuation query). 

$pdbxport 

port name from /etc/remote[.pdbx] used to connect to target machine for pdbx 

$printwhilestep 

For use with the step[/2] and stepi[n] instructions. A non-zero integer specifies that 
all n lines and/or instructions should be printed out. A zero specifies that only the 
last line and/or instruction should be printed out. The default is zero. 

Spimode 

Prints input when used with the playback input command. The default is 0. 

Sprint data 

When set to a nonzero value, the contents of registers used are printed next to each 
instruction displayed. The default is 0. 

Sprintwide 

When se to a nonzero value, the contents of variables are printed in a horizontal for- 
mat. The default is 0. 

Sprompt 

Sets the prompt for dbx, 

Sreadtextfile 

When set to 1, dbx tries to read instructions from the object file rather than the pro- 
cess, dbx executes faster when debugging remotely using the System Programmer's 
Package. This variable should always be set to when the process being debugged 
copies in code during the debugging process. The default is 1. 

$regstyle 

A zero value causes registers to be printed out in their normal r format (r0,rl,...r31). 
A nonzero value causes the registers to be printed out in a special format (zero, at, 
vO, vl,...) commonly used in debugging programs written in assembly langu^e. The 
default is 0. 

Srepeatmode 

When set to a nonzero value, after pressing the RETURN key (for an empty line), 
the last command is repeated. The default is 1. 

$rimode 

When set to a nonzero value, input will is recorded while recording output . The 
default is 0. 

Ssigtramp 

Tells dbx the name of the code called by the system to invoke user signal handlers. 
This variable is set to sigvec for UMIPS-BSD and to sigtramp for UMJPS-V 
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$tagfile Contains a filename, indicating the file in which the tag command and the tabvalue i 

macro are to search for tags. 

Predefined dbx Aliases 

The debugger has these predefined aliases: 

? Prints a list of all dbx commands, 

a Assigns a value to a program variable, 

b Sets a breakpoint at a specified line. 

bp Stops in a specified procedure. 

c Continues program execution after a breakpoint, 

d Deletes the specified item from the status list. 

e Looks at the specified file. 

f Moves to the specified activation level on the stack. 

g Goes to the specified line and begins executing the program there. 

h Lists all items currently on the history list. 

j Shows what items are on the status Ust. 

1 Lists the next 10 lines of source code. 

li Lists the next 10 machine instructions. 

n or S Step over the specified number of lines without stepping into procedure calls. 

ni or Si Step over the specified number of assembly code instructions without stepping into 

procedure calls. /" 

p Prints the value of the specified expression or variable. ^ 

pd Prints the value of the specified expression or variable in decimal. 

pi Replays dbx commands that were saved with the record Input command. 

po Prints the value of the specified expression or variable in octal. 

pr Prints values for all registers, px Prints the value for the specified variable or expres- 

sion in hexadecimal. 

q Ends the debugging session. 

r Runs the program again with the same arguments that were specified with the run 

command. 

ri Records in a file every command typed. 

ro Records all debugger output in the specified file. 

s Steps the next number of specified lines, 

si Steps the next number of specified lines of assembly code instructions. 

t Does a stack trace. 

n Lists the previous 10 lines. 

w Lists the 5 lines preceding and following the current line. 

W Lists the 10 lines preceding and following the current line. 

wi Lists the 5 machine instructions preceding and following the machine instruction. 



( 
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SEE ALSO 

MIPS Languages Programmer Guide . 
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NAME i 

dd - convert and copy a file 

SYNOPSIS 

dd [option==value] ... 

DESCRIPTION 

dd copies the specified input file to the specified output with possible conversions. The stan- 
dard input and output are used by default. The input and output block size may be specified 
to take advantage of raw physical I/O. 

option values 

if== input file name; standard input is default 

of= output file name; standard output is default 

ibs=/i input block size n byte^ (default 512) 

obs=;i output block size (default 512) 

bs-n set both input and output block size, superseding ibs and ob$; also, if no 

conversion is specified, it is particularly efficient since no copy need be done 

cbs-/7 conversion buffer size 

skip==n skip n input records before starting copy 

files-n copy n input files before terminating (makes sense only where input is a 

magtape or similar device). 

seek=/i seek n records from beginning of output file before copying 

co\mt-n copy only n input records 

conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 

block convert variable length records to fixed length i 

unblock convert fixed length records to variable length V 

lease map alphabetic? to lower case 

ucase map alphabetics to upper case 

swab swap every pair of bytes 

noerror do not stop processing on an error 

sync pad every input record to ihs 

... , .., several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may end with kj b or w 
to specify multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated 
by X to indicate a product. 

Cbs is used only if asdh unblock, ebcdic, ibm, or block conversion is specified. In the first two 
cases, cbs characters are placed into the conversion buffer, any specified character mapping is 
done, trailing blanks trimmed and new4ine added before sending the line to the output. In 
the latter three cases, characters are read into the conversion buffer, and blanks added to 
make up an output record of size cbs . 

After completion, dd reports the number of whole and partial input and output blocks. 

For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record 
into the ASCII file x: 

dd if=/dev/rmtO of-x ibs=800 cbs=80 conv=^ascii, lease 

Note the use of raw magtape, dd is especially suited to I/O on the raw physical devices 
because it allows reading and writing in arbitrary record sizes. 



( 
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SEE ALSO 

cp(l), tr(l) 

DIAGNOSTICS 

f+p records in(out): numbers of full and partial records read (written) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the 
CACM Nov, 1968. The 'ibm' conversion, while less blessed as a standard, corresponds better 
to certain IBM print train conventions. There is no universal solution. 

One must specify "conv=noerror,sync" when copying raw disks with bad sectors to insure dd 
stays synchronized. 

Certain combinations of arguments to conv=^ are permitted. However, the block or unblock 
option cannot be combined with ascii, ebcdic or i&m. Invalid combinations silently ignore all 
but the last mutually-exclusive keyword. 
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NAME 

deroff - remove nroff, troff, tbl and eqn constructs 

SYNOPSIS 

deroff [ -w] file ... 

DESCRIPTION 

deroff reads each file in sequence and removes all nroff and troff command lines, backslash 
constructions, macro definitions, eqn constructs (between *.EQ' and *.EN' lines or between 
delimiters), and table descriptions and writes the remainder on the standard output, deroff 
follows chains of included files ('.so' and *.nx' commands); if a file has already been included, 
a *.so' is ignored and a ^nx' terminates execution. If no input file is given, deroff reads from 
the standard input file. 

If the — w flag is given, the output is a word list, one *word' (string of letters, digits, and apos- 
trophes, beginning with a letter; apostrophes are removed) per Hne, and all other characters 
ignored. Otherwise, the output follows the original, with the deletions mentioned above. 

SEE ALSO 

troff(l), eqn(l), tbl(l) 

BUGS 

deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most 
errors result in too ranch rather than too little output, slkfjsldfjsdlslk. 



( 
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NAME 

diction, explain - print wordy sentences; thesaurus for diction 

SYNOPSIS 

diction [ -ml ] [ —mm ] [ -n ] [ — f pfile ] file ... 
explain 

DESCRIPTION 

diction finds all sentences in a, document that contain phrases from a data base of bad or 
wordy diction. Each phrase is bracketed with [ ]. Because diction runs derojf before looking 
at the text, formatting header files should be included as part of the input. The default macro 
package -ms may be overridden with the flag -mm. The flag -ml which causes deroff to skip 
lists, should be used if the document contains many lists of non-sentences. The user may sup- 
ply her/his own pattern file to be used in addition to the default file with -f pfile. If the flag 
—n is also supplied the default file will be suppressed. 

Explain is an interactive thesaurus for the phrases found by diction. 

SEE ALSO 

deroff(l) 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, 
diction doesn't grok —me. 
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NAME I 

dis " disassemble an object file 

SYNOPSIS 

di$ [-h] [-s] [-P procedure] [file .., ] 

DESCRIPTION 

Dis disassembles object files into machine instructions. Please note that assember code and 
machine code can differ on this machine. For a full description of the machine language, see 
the R2000 Processor User's Guide. A file can be an object or an archive. 

The -^h, flag causes the general register names to be printed, rather than the software register 
names. The ^p flag disassembles only the specified procedure from the object file. The -S 
causes source lisitings to be listed, Otherwise, only instructions will listed. 

BUGS 

Disassembling an archive is not currently operational. 
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NAME 

du - summarize disk; usage 

SYNOPSIS 

du [ -a ] [ -f ] [ -s ] [ name ... ] 

DESCRIPTION 

du gives the number of kilobytes contained in all files and, recursively, directories within, each 
specified directory or file name. If name is missing, '.' is used. 

The option -s causes only the grand total to be given. 

The option -a causes an entry to be generated for each file. Absence of either causes an 
entry to be generated for each directory only. 

The option -^f causes the size calculation of directories to ignore sizes of subdirectories. This 
is useful for finding ^'fat" directories (those that have lots of files at the top level, as opposed 
to trees that have lots of files). 

A file which has two links to it is only counted once. 

SEE ALSO 

df(l), quot(8) 

BUGS 

Non-directories given as arguments (not under -^a option) are not Hsted. 

In previous versions of du , if there are too many distinct linked files, du counts the excess 
files multiply. 

Previous versions of du required options to be in the order — s followed by —a if both are 
given. This version uses getopt(3), and thus any order is allowed. 
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NAME 

eqn, neqn, checkeq - typeset mathematics 

SYNOPSIS 

eqn [ -dxy ] [ «pn ] [ -sn ] [ -fn ] [ file ] ... 
checkeq [ file ] . . . 

DESCRIPTION 

eqn is a troff(l) preprocessor for typesetting mathematics on a Graphic Systems photo- 
typesetter, neqn on terminals. Usage is almost always 

eqn file ... | troff 
neqn file ... |nroff 

If no files are specified , these programs read from the standard input. A line beginning with 
*.EQ' marks the start of an equation; the end of an equation is marked by a line beginning 
with '.EN'. Neither of these Unes is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to set two characters as 'delimiters'; subsequent 
text between delimiters is also treated as eqn input. Delimiters may be set to characters x and 
y with the command-Hne argument — dbcy or (more commonly) with 'delim xy' between .EQ 
and .EN. The left and right delimiters may be identical. Delimiters are turned off by 'delim 
off. All text that is neither between delimiters nor between .EQ and .EN is passed through 
untouched. 

The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, newlines, braces, double quotes, tildes or 
circumflexes. Braces {} are used for grouping; generally speaking, anywhere a single character 
like X could appear, a compUcated construction enclosed in braces may be used instead. 
Tilde ~ represents a full space in the output, circumflex " half as much. 

Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes 
Xi , a sub i sup 2 produces a^, and e sup {x sup 2 ■¥ y sup 2} gives e^ "^ . 

Fractions are made with over: a over b yields -— . 

b 

sqrt makes square roots: 1 over sqrt {ax sup 2 +&;t:+c} results in 



'\/ax'^+bx-\-c 



The keywords from and to introduce lower and upper limits on arbitrary things: lii^/ is 

made with Urn from {«-> inf } sum from to n x sub i. 

Left and right brackets, braces, etc., of the right height are made with left and right: left [ x 



sup 2 -{- y sup 2 over alpha right J ^=~i produces 



2 y' 

x^+^^— 



= 1. The right clause is optional. 



Legal characters after left and right are braces, brackets, bars, c and f for ceiling and floor, 
and "" for nothing at aU (useful for a right-side-only bracket). 

Vertical piles of things are made with pile, Ipile, cptte, and rpile: pile {a above b above c} 

a 
produces b. There can be an arbitrary number of elements in a pile. Ipile left-justifies, pile 

c 
and cpile center, with different vertical spacing, and rpile right justifies. 

Matrices are made with matrix: matrix { Icol { x sub i above y sub 2 } ccol { 1 above 2 } } pro- 

Xi 1 
duces 2* I^ addition, there is rcol for a right-justified column. 
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Diacritical marks are made with dot, dotdot, hat, tiid^, bar, vec, dyad, and under: x dot = f 

f(t) bar is i -fJF), y dotdot bar "="' n under isy ^ a, and x vec '"='^ y dyad is x" ==3 f. 

Sizes and font can be changed with size n or size db^, roman, italic, bold, and font n. Size 
and fonts can be changed globally in a document by gsize n and gfont n , or by the command- 
line arguments -«sn and "^(h. 

Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this 
may be changed by the command-line argument -^pn. 

Successive display arguments can be lined up. Place mark before the desired lineup point in 
the first equation; place lineup at the place that is to line up vertically in subsequent equa- 
tions. 

Shorthands may be defined or existing keywords redefined with define; define thing % replace- 
ment % defines a new token called thing which will be replaced by replacement whenever it 
appears thereafter. The % may be any character that does not occur in replacement. 

Keywords like suni^ int (J) inf (00) and shorthands like >= (>) -^> (-^), and != (7^) are 
recognized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. 
Mathematical words like sin, cos, log are made Roman automatically. Troff(l) four-character 
escapes like \(bs (0) can be used anywhere. Strings enclosed in double quotes "..." are 
passed through untouched; this permits keywords to be entered as text, and can be used to 
communicate with tro ffwh^n all else fmls. 

SEE' ALSO 

troff(l), tbl(l), ms(7), eqnchar(7) 

B. W. Kemighan and L, L. Cherry, Typesetting Mathematics-r-User's Guide 

J. F, Ossanna, NROFF/TROFF User's Manual g 

BUGS \ 

To embolden digits, parens, etc., it is necessary to quote them, as in 'bold "12.3"'. 
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NAME 

error - analyze and disperse compiler error messages 

SYNOPSIS 

error [ — n ] [ vs ] [ — q ] [ -v ] [ ^t suffixlist ] [ -I ignorefile ] [ name ] 

DESCRIPTION 

error analyzes and optionally disperses the diagnostic error messages produced by a number of 
compilers and language processors to the source jSile and line where the errors occurred. It 
can replace the painful, traditional methods of scribbling abbreviations of errors on paper, 
and permits error messages and source code to be viewed sin^ultaneously without machina- 
tions of multiple windows in a screen editor. 

error looks at the error messages, either from the specified file name or from the standard 
input, and attempts to determine which language processor produced each error message, 
determines the source file and line number to which the error message refers, determines iJf 
the error mess^e is to be ignored or not, and inserts the (possibly slightly modified) error 
message into the source file as a comment on the line preceding to which the line the error 
message refers, error messages which can't be categorized by language processor or content 
are not inserted into any file, but are sent to the standard output, error touches source files 
only after all input has been read. By specifying the -q query option, the user is asked to 
confirm any potentially dangerous (such as touching a file) or verbose action. Otherwise error 
proceeds on its merry business. If the — t touch option and associated suffix Ust is given, error 
will restrict itself to touch only those files with suffices in the suffix list, error also can be 
asked (by specifying -^v) to invoke v/(l) on the files in which error messages were inserted; 
this obviates the need to remember the names of the files with errors, 

error is intended to be run with its standard input connected via a pipe to the error message 
source. Some language processors put error messages on their standard error file; others put 
their messages on the standard output. Hence, both error sources should be piped together 
into error. For example, when using the csh syntax, 

make -s lint |& error -q -v 

will analyze all the error messages produced by whatever programs make runs when making 
lint. 

error knows about the error messages produced by: make, cc, cpp, ccom, as. Id, lint, pi, pc, 
P7, and DEC Western Research Modula-2, error knows a standard format for error messages 
produced by the language processors, so is sensitive to changes in these formats. For all 
languages except Pascal, error messages are restricted to be on one line. Some error messages 
refer to more than one line in more than one files; error will dupUcate the error message and 
insert it at all of the places referenced. 

error will do one of six things with error messages. 

synchronize 

Some language processors produce short errors describing which file it is process- 
ing, error uses these to determine the file name for languages that don't include the 
file name in each error message. These synchronization messages are consumed 
entirely by error. 

discard error messages from lint that refer to one of the two lint libraries, /usr/lib/llib-lc 
and /usr/lib/llib-port are discarded, to prevent accidently touching these libraries. 
Again, these error messages are consumed entirely by error. 

nullify error messages from lint can be nullified if they refer to a specific function, which 
is known to generate diagnostics which are not interesting. Nullified error messages 
are not inserted into the source file, but are written to the standard output. ITie 
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names of functions to ignore are taken from either the file named .errorrc in the f 

users's home directory, or from the file named by the —I option. If the file does 
not exist, no error messages are nullified. If the file does exist, there must be one 
function name per line. 

not file specific 

error messages that can't be intuited are grouped together^ and written to the stan- 
dard output before any files are touched. They will not be inserted into any source 
file. 

file specific 

error message that refer to a specific file, but to no specific line, are written to the 
standard output when that file is touched. 

true errors error messages that can be intuited are candidates for insertion into the file to 
which they refer. 

Only true error messages are candidates for inserting into the file they refer to. Other error 
messages are consumed entirely by error or are written to the standard output, error inserts 
the error messages into the source file on the line preceding the line the language processor 
found in error. Each error message is turned into a one line comment for the language, and is 
internally flagged with the string ''###" at the beginning of the error, and **%%%" at the end 
of the error. This makes. pattern searching for errors easier with an editor, and allows the 
messages to be easily removed. In addition, each error message contains the source line 
number for the line the message refers to. A reasonably formatted source program can be 
recompiled with the error messages still in it, without having the error messages themselves 
cause future errors. For poorly formatted source programs in free format languages, such as C 
or Pascal, it is possible to insert a comment into another comment, which can wreak havoc ^ 

with a future compilation. To avoid this, programs with comments and source on the same I 

fine should be formatted so that language statements appear before comments. 

Options available with error are: 

•»-ii Do not touch any files; all error messages are sent to the standard output. 

— q The user is queried whether s/he wants to touch the file. A "y" or *'n" to the question is 
necessary to continue. Absence of the — q option implies that all referenced files 
(except those referring to discarded error messages) are to be touched. 

— v After all files have been touched, overlay the visual editor vi with it set up to edit all files 
touched, and positioned in the first touched file at the first error. If vi can't be found, 
try ex or eJ from standard places. 

-t Take the following argument as a suffix list. Files whose suffixes do not appear in the 
suffix Ust are not touched. The suffix Ust is dot separated, and "*" wildcards work. 
Thus the suffix Hst: 

".c.y.foo^.h" 

allows error to touch files ending with "x", ".y", ".foo*" and ''.y". 

—s Print out ^/fl//^ric^ regarding the error categorization. Not too useful. 

error catches interrupt and terminate signals, and if in the insertion phase, will orderly ter- 
minate what it is doing. 

AUTHOR 

Robert Henry 

FILES 

7. errorrc function names to ignore for lint error messages 

/dev/tty user's teletype 
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BUGS 

Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor's format of error messages may cause error to not understand 
the error message. 

error^ since it is purely mechanical, will not filter out subsequent errors caused by *floodgating' 
initiated by one syntactically trivial error. Humans are still much better at discarding these 
related errors. 

Pascal error messages belong after the lines affected (error puts them before). The alignment 
of the * I' marking the point of error is also disturbed by error, 

error was designed for work on CRT's at reasonably high speed. It is less pleasant on slow 
speed terminals, and has never been used on hardcopy terminals. 
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NAME 

expand, unexpand - expand tabs to spaces, and vice versa 

SYNOPSIS 

expand [ -tabstop ] [ ~tabl,tab2,.,.,tabn ][ file ... ] 
unexpand [ —a ] [ file ... ] 

DESCRIPTION 

expand processes the named files or the standard input writing the standard output with tabs 
changed into blanks. Backspace characters are preserved into the output and decrement the 
column count for tab calculations, expand is useful for pre-processing character files (before 
sorting, looking at specific columns, etc.) that contain tabs. 

If a single tabstop argument is given, then tabs are set tabstop spaces apart instead of the 
default 8. If multiple tabstops are given then the tabs are set at those specific columns. 

Unexpand puts tabs back into the data from the standard input or the named files and writes 
the result on the standard output. By default, only leading blanks and tabs are reconverted to 
maximal strings of tabs. If the —a option is given, then tabs are inserted whenever they would 
compress the resultant file by replacing two or more characters. 
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NAME 

f77 - MIPS Fortran 77 compiler 

SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77, the MIPS ucode Fortran 77 compiler, produces files in the following formats: MIPS 
object code in MIPS extended cojf format (the normal result), binary or symbolic ucode , 
ucode object files and binary or symbolic assembly language. F77 accepts several types of 
arguments: 

Arguments whose names end with '.f are assumed to be Fortran 77 source programs. They 
are compiled, and each object program is left in the file whose name consists of the last com- 
ponent of the source with So' substituted for '.f . The *.o' file is only deleted when a single 
source program is compiled and loaded all at once. Files ending in *.F' are assumed to con- 
tain Fortran code which is to be run through the C preprocessor first. 

Arguments whose names end with '.r' or Se' are assumed to be RATFOR or EFL source pro- 
grams, respectively. These programs are first transformed by the appropriate preprocessor 
and then compiled by /77, producing '.o' files. 

Arguments whose names end with *.s' are assumed to be symbolic assembly language source 
programs. They are assembled, producing a '.o' file. Arguments whose names end with '.i' 
are assumed to be Fortran 77 source after being processed by the C preprocessor. They are 
compiled without being processed by the C preprocessor. 

If the highest level of optimization is specified (with the -03 flag) or only ucode object files 
are to be produced (with the -j flag) each Fortran 77, RATFOR or EFL source file is compiled 
into a ucode object file. The ucode object file is left in a file whose name consists of the last 
component of the source with '.u' substituted for *.f , Sr', or '.e'. 

The suffixes described below primarily aid compiler development and are not generally used. 
Arguments whose names end with '.B', '.O', *.S', and *.M' are assumed to be binary ucode^ 
produced by the front end, optimizer, ucode object file splitter and ucode merger respectively. 
Arguments whose names end with MJ^ are assumed to be symbolic ucode. Arguments whose 
names end with '.G' are assumed to be binary assembly language, which is produced by the 
code generator and the symbolic to binary assembler. 

Files that are assumed to be binary ucode , symbolic ucode y or binary assembly language by 
the suffix conventions are also assumed to have their corresponding symbol table in a file with 
a \T suffix. 

F77 always defines the C preprocessor macros mips, host_jmips and unix to the C macro 
preprocessor. If the — cpp option is present p? defines the C preprocessor macro 
LANGUAGE_FORTRAN when a '.f , \r\ or '.e' file is being compiled. F77 Will define the C 
preprocessor macro LANGUAGE_ASSEMBLY when a Ss' file is being compiled. It also 
defines SYSTYPE_SYSV by default but this changes if the — systype name option is specified 
(see the description below). 

The following options are interpreted by /77 and have the same meaning in cc(l). See /d(l) 
for load-time options. 

—c Suppress the loading phase of the compilation and force an object file to be pro- 

duced even if only one program is compiled. 

—gO Have the compiler produce no symbol table information for symbolic debugging. 
This is the default. 

— gl Have the compiler produce additional symbol table information for accurate but 
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limited symbolic debugging of partially optimized code. i 

-g or -g2 

Have the compiler produce additional symbol table information for full symbolic 
debugging and not do optimizations that limit full symbolic debugging. 

--g3 Have the compiler produce additional symbol table information for full symbolic 
debugging for fully optimized code. This option makes the debugger inaccurate. 

— w Suppress warning messages. - ' 

— pO Do not permit any profiling. This is the default. If loading happens, the standard 
runtime startup routine (crtl.o) is used, no profiling library is searched. 

—pi or —p 

Set up for profihng by periodically sampling the value of the program counter. This 
option only effects the loading. When loading happens, this option replaces the stan- 
dard runtime startup routine with the profiling runtime startup routine (mcrtl.o) and 
searches the level 1 profiling library (libprofl,a). When profiling happens, the startup 
routine calls monstartup (3) and produces a file mon.out that contains execution- 
profiling data for use with the postprocessor /?r(9/(l). 

— OO Turn off all optimizations. 

"-01 Turn on all optimizations that can be done quickly. This is the default. 

-O or -02 

Invoke the global ucode optimizer. --OS Do all optimizations, including global regis- 
ter allocation. This option must precede all source file arguments. With this option, 
a ucode object file is created for each Fortran 77, RATFOR, or EFL source file and 
left in a *.u' file. The newly created ucode object files, the ucode object files 
specified on the command line and the runtime startup routine and all the runtime 
libraries are ucode linked. Optimization is done on the resulting ucode linked file 
and then it is linked as normal producing an "a.out" file. No resulting '.o' file is left 
from the ucode linked result as in previous releases. In fact --c can no longer be 
specified with —03. 

—feedback /i/e 

Used with the —cord option to specify ///e to be used as a feedback file. This j^/^ is 
produced by prof(l) with its —feedback option from an execution of the progran^ 
produced by /?/x/6(l). 

—cord Run the procedure-rearranger, cord{l), on the resulting file after linking. The rear- 
rangement is done to reduce the cache conflicts of the program's text. The output of 
cord(l) is left in the file specified by the — o output option or 'a. out' by default. At 
least one —feedback ^/g must be specified. 

— j Compile the specified source programs, and leave the ucode object file output in 

corresponding files suffixed with '.u'. 

— ko output 

Name the output file created by the ucode loader as output. This file is not removed. 
If this file is compiled, the object file is left in a file whose name consists of output 
with the suffix changed to a *.o'. If output has no suffix, a *.6' suffix is appended to 
output. 

— k Pass options that start with a — k to the ucode loader. This option is used to specify 

ucode libraries (with — kk ) and other ucode loader options. 

— S Compile the specified source programs and leave the symbohc assembly language out- 

put in corresponding files suffixed with *.s'. 
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— P Run only the C macro preprocessor and put the result for each source file (by suffix 

convention, i.e. '.f , '.r', *.e' and *.s^) in a corresponding'.i' file after being processed 
by appropriate preprocessors. The M^ file has no '#' lines in it. This sets the — cpp 
option. 

— E Run only the C macro preprocessor on the files (regardless of any suffix or not), and 

send the result to the standard output. This sets the — cpp option. 

— o output 

Name the final output file output. If this option is used, the file 'a. out' is undis- 
turbed. 

'-Dname=def 
—Dname 

Define the name to the C macro preprocessor, as if by ^#define\ If no definition is 

given, the name is defined as "1". 

Remove any initial definition of name , 

-I<ijr '#include' files whose names do not begin with 7' are always sought first in the direc- 
tory of the file argument, then in directories specified in —I options, and finally in the 
standard directory (/usr/include). 

—I This option will cause *#include' files never to be searched for in the standard direc- 

tory (/usr/include). 

'-G num 

Specify the maximum size, in bytes, of a data item that is to be accessed from the 
global pointer. Num is assumed to be a decimal number. If num is zero, no data is 
accessed from the global pointer. The default value for num is 8 bytes. 

—V Print the passes as they execute with their arguments and their input and output files. 

—V Print the version of the driver and the versions of all passes. This is done with the 

what{l) command. 

— std Have the compiler produce warnings for things that are not standard in the language. 

—cpp Run the C macro preprocessor on all Fortran source files before compiling. This 
includes Fortran sources created by RATFOR or EFL . 

— nocpp 

Do not run the C macro preprocessor on any Fortran source files before compiling. 
This is the default for m/77(l). This includes Fortran sources created by RATFOR or 
EFL. 

— Olimit num 

Specify the maximum size, in basic blocks, of a routine that will be optimized by the 
global optimizer. If a routine has more than this number of basic blocks it will not 
be optimized and a message will be printed. An option specifying that the global 
optimizer is to be run (—O, — 02, or — 03) must also be specified. Num is assumed 
to be a decimal number. The default value for num is 500 basic blocks. 

Either object file target byte ordering can be produced by p7. The default target byte order- 
ing matches the machine where the compiler is running. The options — EB and —EL specify 
the target byte ordering (big-endian and little-endian, respectively). The compiler also defines 
a C preprocessor macro for the target byte ordering. These C preprocessor macros are MIP- 
SEB and MIFSEL for big-endian and little-endian byte ordering respectively. 
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K the specified target byte ordering does not match the machine where the compiler is run- 
ning, then the runtime startups and libraries come from /usr/Iibeb for big-endian runtimes on 
a Httle-endian machine and from /usr/iibel for little-endian runtimes on a big-endian machine. 

-EB Produce object files targeted for big-endian byte ordering. The C preprocessor macro 
MIPSEB is defined by the compiler. 

-EL Produce object files targeted for little-endian byte ordering. The C preprocessor 
macro MIPSEL is defined by the compiler. 

The following options are specific for /77: 

-12 Make the default integer constants and variables short. All logical quantities will be 
short. — i4 is the default. 

— onetrip or —1 

Compile DO loops that execute at least once if reached. (Fortran 77 DO loops are not 
executed if the upper limit is smaller than the lower limit.) 

•-'66 Suppress extensions that enhance Fortran 66 compatibility. 

-C Generate code for runtime subscript range checking. The default suppresses range 
checking. 

-U Do not "fold'' cases. F77 is normally a no-case language (for example a equals A). 
The — U option causes /77 to treat uppercase and lowercase separately. 

--n Make the default type of a variable undefined, rather than using the default Fortran 
rules. 

-w Suppress all warning messages. If the option is -w66, only Fortran 66 compatibility 
warnings are suppressed. 

"-wl Suppress warnings about unused variables (but permit other warnings unless -w is also 
specified). 

-F Apply the EFL and RATFOR preprocessors to relevant files and put the result in files 
whose names have their suflBx changed to '.f . (No *,o' files are created.) 

-m Apply the M4 preprocessor to each EFL or RATFOR source file before transforming it 
with the ratfor{l) or efl(l) preprocessors. The temporary file used as the output of the 
m4{l) preprocessor is that of the last component of the source file with a '.p' substi- 
tuted for the '.e' or '.r'. This temporary file is removed unless if the -K option is 
specified. 

-E Use any remaining characters in the argument as EFL options whenever processing a 
'.e' file. The temporary file used as the output of the EFL preprocessor has the last 
component of the source file with a '.f substituted for the '.e'. This temporary file is 
removed unless the -K option is specified. 

-R Use any remaining characters in the argument as RATFOR options whenever process- 
ing a '.r' file. The temporary file used as the output of the RATFOR preprocessor is 
that of the last component of the source file with a *.f substituted for the *.r'. This 
temporary file is removed unless the -K option is specified. 

— automatic 

Place local variables on the runtime stack. The same restrictions apply for this option 
as they do for the automatic keyword. This is the default. 

—static 

Cause all local variables to be staticly allocated. 

— noex:tend_soiirce 

Pad each source line with blanks or truncate it as need be to make it 72 bytes long. 
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— ext^nd^sQurce 

Pad each source line with blanks if need be to make it 132 bytes long, but do not trun- 
cate it if it exceeds 132 bytes. 

— djines 

The djines option specifies that lines with a D in column 1 are to be compiled and 
not to be treated as comment lines. The default is to treat lines with a D in column 1 
as comment lines. 

'-colTZ This option sets the SVS Fortran 72 column option mode for source statements. 

-CO1120 

This option sets the SVS Fortran default mode for source statements. 

Cause the runtime system to behave Uke VMS Fortran with regard to interpreting car- 
riage control on unit 6. 

— N[qxscnl]nnn 

Make static tables in the compiler bigger. The compiler will complain if it overflows its 
tables and suggest you apply one or more of these flags. These flags have the following 
meanings: 

q Maximum number of equivalenced variables. Default is 150. 

X Maximum number of external names (common block names, subroutine and 

function names). Default is 200. 

s Maximum number of statement numbers. Default is 401. 

c Maximum depth of nesting for control statements (e.g. DO loops). Default is 

20. 

n Maximum number of identifiers. Default is 1009. 

I Maximum number of labels. Default is 125. 

The option described below is primarily used to provide UNDC compilation environments 
other than the native compilation environment. 

■^systype name 

Use the named compilation environment name. See compilation {J) for the compila- 
tion environments that are supported and their names. This has the effect of changing 
the standard directory for '#include' files, the runtime libraries and where runtime 
libraries are searched for. The new items are located in their usual paths but with 
Iname prepended to their paths. Also a preprocessor macro of the form 
SYSTYPE^AMME (with name capitalized) is defined in place of the default 
SYSTYPE^SYSY- 

The options described below primarily aid compiler development and are not generally used: 

-He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ fjusmoca ]• It selects the compiler pass in the 
same way as the — t option. If this option is used, the symbol table file produced and 
used by the passes, is the last component of the source file with the suffix changed to 
'.T' and is not removed. 

— K Build and use intermediate file names with the last component of the source file's 
name replacing its suffbc with the conventional suffix for the type of file (for example 
'.B' file for binary ucode, produced by the front end). These intermediate files are 
never removed even when a pass encounters a fatal error. When ucode linking is per- 
formed and the —K option is specified the base name of the files created after the 
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ucode link is ^u.out' by default. If — ko output is specified, the base name of the 
object file is output without the suffix if it exists or suffixes are appended to output if it 
has no suffix. 

— # Converts binary ucode files (SB') or optimized binary ucode files ('.O') to symbolic 
ucode (a MJ' file) using btouil). If a symbolic ucode file is to be produced by con- 
verting the binary ucode from the Fortran 77 compiler front end then the front end 
option "--Xu is used instead of btou(l). 

'-'Wc[c..J,argl[,arg2...j 

Pass the argument[s] argi to the compiler pass[es] c[c.,]. The c's are one of [ pfjusmo- 
cablyz ]. The c's selects the compiler pass in the same way as the — t option. 

The options ■^t[hpfjusmocablyzrFIUSMnt], •^hpath, and ^Bstring select a name to use for a 
particular pass, startup routine, or standard library. These arguments are processed from left 
to right so their order is significant. When the -B option is encountered, the selection of 
names takes place using the last -h and -t options. Therefore, the ^B option is always 
required when using — h or -^t. Sets of these options can be used to select any combination of 
names. 

The -EB or —EL options, the -p[01] options and the -systype option must precede all '^B 
options because they can affect the location of runtimes and what runtimes are used. 

--t[hpfjusmocablyzrFIUSMnt] 

Select the names. The names selected are those designated by the characters follow- 
ing the ^t option according to the following table: 

Name Character 



include 


h (see note below) 


cpp 


P 


fcom 


f 


ujoin 


J 


uld 


u 


uspht 


s 


umerge 


m 


uopt 


o 


ugen 


c 


asO 


a 


asl 


b 


Id 


1 


ftoc 


y 


cord 


z 


[m]crt[ln].o 


r 


libF77.a 


F 


UbI77,a 


I 


libU77.a 


U 


libisam.a 


s 


libm.a 


M 


libprofl.a 


n 


btou, utob 


t 



If the character 'h' is in the — t argument then a directory is added to the list of direc- 
tories to be used in searching for *#include' files. This directory name has the form 
COMP„TARGET_ROOT/usr/include5'^m^ . This directory is to contain the include files 
for the string release of the compiler. The standard directory is still searched. 

--hpath 

Use path rather than the directory where the name is normally found. 
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FILES 



•^Bstring 

Append string to all names specified by the -t option. If no -t option has been pro- 
cessed before the -B, the -t option is assumed to be "hpfjusmocablyzrFIUSMnt". 
This list designates all names. If no -t argument has been processed before the ~B 
then a --Bstring is passed to the loader to use with its -Ix arguments. 

Invoking the compiler with a name of the form tllstring has the same effect as using a 
—Bstring option on the command Hne. 

If the environment variable COMP_HOST_ROOT is set, the value is used as the root directory 
for all pass names rather than the default /. If the environment variable 
COMP_TARGET„ROOT is set, the value is used as the root directory for all include and library 
names rather than the default /. This affects the standard directory for ^#include' files, 
/usr/include, and the standard library, /usr/lib/libc.a. If this is set, the first directory that is 
searched for libraries, using the -\x option, is COMP_TARGET_ROOT/usr/lib/cmplrs/cc. The 
standard directories for libraries are then searched, see W(l). 

If the environment variable TMPDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ . 

If the environment variable RLSJD_OBJECT is set, the value is used as the name of an object 
1 link in if a link takes place. This is used to add release identification information to 
objects. It is always the last object specified to the loader. See rlsJd{V) for the tools to 
create this information. 

Other arguments are assumed to be either loader options or Fortran 77-compatible object 
files, typically produced by an earlier p? run, or perhaps libraries of Fortran 77-compatible 
routines. These files, together with the results of any compilations specified, are loaded in the 
order given, producing an executable program with the default name a.out. 



file.f 

file.o 

a.out 

/tmp/ctm? 

/usr/lib/cpp 

/usr/lib/fcom 

/usr/lib/ujoin 

/usr/bin/uld 

/usr/lib/usplit 

/usr/lib/umerge 

/usr/lib/uopt 

/usr/lib/ugen 

/usr/lib/asO 

/usr/lib/asl 

/usr/lib/crtl.o 

/usr/lib/crtn.o 

/usr/lib/mcrtl.o 

/usr/lib/libc.a 

/usr/lib/libprofl.a 

/usr/lib/libF77.a 

/usr/lib/libI77.a 

/usr/lib/libU77.a 

/usr/lib/libisam.a 

/usr/lib/libm.a 

/usr/include 



input file 

object file 

loaded output 

temporary 

C macro preprocessor 

Fortran 77 front end 

binary ucode and symbol table joiner 

ucode loader 

binary ucode and symbol table splitter 

procedure intergrator 

optional global ucode optimizer 

code generator 

symbolic to binary assembly language translator 

binary assembly language assembler and reorganizer 

runtime startup 

runtime startup 

startup for profiling 

standard library, see mtro(3) 

level 1 profiHng library 

Fortran intrinsic function library 

Fortran I/O library 

Fortran UNIX interface library 

Indexed sequential access method library 

Math library 

standard directory for '#include' files 
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/usr/bin/ld MIPS loader ^ 

/u$r/lib/ftoc interface between pro/(l) and ct?rd(l) 

/usr/lib/cord procedure-rearranger 

/usr/bin/btou binary to symbolic ucode translator 

/usr/bin/utob symbolic to binary ucode translator 

/usr/bin/efl extended Fortran language preprocessor 

/usr/bin/ratfor rational Fortran dialect preprocessor 

mon.out file produced for analysis by pw/(l) 

Runtime startups and libraries for the opposite byte sex of machine the compiler is running on 
have the same names but are located in different directories. For big-Indian runtimes on a 
little-endian machine the directory is /usr/libeb and for little-endian runtimes on a big-endian 
machine the directory is /usr/libel. 

SEE ALSO 

Languages Programmer's Guide 

cc(l), as(l), efl(l), ratfor(l), m4(l), monstartup(3), prof(l), ld(l), dbx(l), what( 

DIAGNOSTICS 

The diagnostics produced by /77 are intended to be self-explanatory. Occasional messages can 
be produced by the assembler or loader, 

NOTES 

The standard library, /usr/Ub/libc.a, is loaded by using the 4c loader option and not a full 
path name. The wrong one could be loaded if there are files with the name Vihc.^tring in the 
directories specified with the -L loader option or in the default directories searched by the 
loader. 



The handling of include directories and libc.a is confusing. 



( 
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NAME 

find - find files 

SYNOPSIS 

find pathname-list expression 
find pattern 

DESCEIPTION 

In the first form above, find recursively descends the directory hierarchy for each pathname in 
the pathname-list (i.e., one or more pathnanies) seeking files that match a boolean expression 
written in the primaries given below. In the descriptions, the argument n is used as a decimal 
integer where +n means more than n, -n means less than n and n means exactly n. 

The second form rapidly searches a database for all pathnames which match pattern . Usually 
the database is recomputed weekly and contains the pathnames of all files which are publicly 
accessible. If escaped, normal shell '^globbing'' characters (S', *?', *[', and ']') may be used in 
pattern, but the matching differs in that no characters (e.g, T) have to be matched explicitly. 
As a special case, a simple pattern containing no globbing characters is matched as though it 
were ^pattern*; if any globbing character appears there are no implicit globbing characters. 

—name filename 

True if the filename argument matches the current file name. Normal shell argu- 
ment syntax may be used if escaped (watch out for '[\ *?' and **'). 

—perm onum 

• True if the file permission flags exactly match the octal number onum (see 
chmod{l)). If onum is prefixed by a minus sign, more flag bits (017777, see stat{2)) 
become significant and the flags are compared: (flags&onum) = =onum . 

— fstype type 

True if the filesystem to which the file belongs is of type type, where type is typically 
4.3 or nfs. 

-type c True if the type of the file is c, where c is b, c, d, f^ 1, p or s for block special file, 
character special file, directory, plain fale, symbolic fink, fifo, or socket. 

—links n True if the file has n links. 

-prune Always true. Has the side effect of pruning the search tree at the file. That is, if 
the current pathname is a directory, find will not descend into that directory. 

-depth Always true, Has the side effect of causing a depth-first search; That is, the chil- 
dren of the directory are processed before the directory itself. The options ^cpio 
and — ncpio cause —depth to be turned on by default. 

—user uname 

True if the file belongs to the user uname (login name or numeric user ID). 

-nouser True if the file belongs to a user not in the /etc/passwd database. 

—group gname 

True if the file belongs to group gname (group name or numeric group ID). 

— nogroup 

True if the file belongs to a group not in the /etc/group database. 

—size n True if the file is n blocks long (512 bytes per block). 

— inum n True if the file has inode number n, 

— atime n True if the file has been accessed in n days. 

-ctime n True if the inode has been changed in n days (see ls(l) for more information). 
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'^mtime n True if the file has been modified in n days. 

*~exec command 

True if the executed command returns a zero value as exit status. The end of the 
command must be punctuated by an escaped semicolon. A command argument 
^{y is replaced by the current pathname. 

"-ok command 

Like —exec except that the generated command is written on the standard output, 
then the standard input is read and the command executed only upon response "y. 

-sprint Always true; causes the current pathname to be printed, 

—Is Always true; causes current pathname to be printed together with its associated 

statistics. These include (respectively) inode number, size in kilobytes (1024 bytes), 
protection mode, number of hard links, user, group, size in bytes, and 
modification time. If the file is a special file the size field will instead contain the 
major and minor device numbers. If the file is a symbolic Unk the pathname of the 
linked-tQ file is printed preceded by **->'■. The format is identical to that of *-ls 
-gilds'' (note however that formatting is done internally, without executing the Is 
program). 

■^newer file 

True if the current file has been modified more recently than the axgnment file. 

— cpio file Write the current file on the argument file in standard cpio forniiat. Implies 
-^depth. 

■^ncpio file 

Write the current file on the argument file in ASCH (--C) cpio format. Implies 
-'depth, 

— xdev Always true; causes find not to traverse down into a file system different from the 
one on which current argument pathname resides. 

The primaries may be combined using the following operators (in order of decreasing pre- 
cedence): 

1) A parenthesized group of primaries and operators (parentheses are special to the Shell 
and must be escaped). 

2) The negation of a primary (M' is the unary not operator). 

3) Concatenation of primaries (the and operation is implied by the juxtaposition of two pri- 
maries). 

4) Alternation of primaries ('-o' is the or operator). 

EXAMPLES 

To find all accessible files whose pathname contains 'find': 

find find 
To typeset all variants of manual pages for Is': 

vtroff -man *find '*mam/ls.?" 

To remove all files named 'a. out' or **.o' that have not been accessed foj* a week: 

find / \( -name a. out -o -name '*.o' \) -atime +7 -exec rm {} \; 

The following will print Wike information for all files in the current directory and subdirec- 
tories except for files in RCS directories: 

find . -name RCS -prune -o -print m 
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FILES 

/etc/passwd 

/etc/group 

/usr/lib/find/flmd. codes coded pathnames database 

SEE ALSO 

sh(l), test(l), fs(5) 

Relevant paper in February, 1983 issue of ;hgin:, 

BUGS 

The first form's syntax is painful, and the second form's exact semantics is confusing and can 

vary from site to site. 

More than one '-newer' option does not work properly. 
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NAME 

fmt - simple text formatter 

SYNOPSIS 

fait [ name .., ] 

DESCRIPTION 

fmt is a simple text formatter which reads the concatenation of input files (or standard input if 
none are given) and produces on standard output a version of its input with lines as close to 
72 characters long as possible. The spacing at the beginning of the input lines is preserved in 
the output, as are blank lines and interword spacing. 

fmt is meant to format mail messages prior to sending, but may also be useful for other simple 
tasks. For instance, within visual mode of the ex editor (e.g. vi) the command 

!}fmt 
will reformat a paragraph, evening the lines. 

SEE ALSO 

nroff(l), mail(l) 

AUTHOR 

Kurt Shoens 

BUGS 

The program was designed to be simple and fast - for more complex operations, the standard 
text processors are likely to be more appropriate. 



( 
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NAME 

from - who is my mail from? 

SYNOPSIS 

from [ — s sender ] [ user ] 

DESCRIPTION 

from prints out the mail header lines in your mailbox file to show you who your mail is from. 
If user is specified, then user's mailbox is examined instead of your own. If the -s option is 
given, then only headers for mail sent by sender are printed. 

fii:,e;s 

/usr/spool/mail/* 

SEE ALSO 

biff(l), mail(l) 
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NAME \ 

fsplit - split a multi-routine Fortran iBile into individual files 

SYNOPSIS 

fsplit [ -e efile] ... [file] 

DESCRIPTION 

fsplit takes as input either a file or standard input containing Fortran source code, It attempts 
to split the input into separate routine files of the form name.f, where name is the name of the 
program unit (e.g. function, subroutine, block data or program). The name for unnamed 
block data subprograms has the form MkdtaNNNJ where NNN is three digits and a file of this 
name does not already exist. For unnamed main programs the name has the form 
mainNNN.f, If there is an error in classifying a program unit, or if name,/ already exists, the 
program unit will be put in a file of the form zzzNNN.f where zzzNNN.f does not already exist. 

Normally each subprogram unit is split into a separate file. When the -e option is used, only 
the specified subprogram units are split into separate files. E.g.: 

fsplit -e readit -e doit prog.f 
will split readit and doit into separate files. 

DIAGNOSTICS 

If names specified via the -e option are not found, a diagnostic is written to standard error, 

AUTHOR 

Asa Romberger and Jerry Berkman 

BUGS 

fsplit assumes the subprogram name is on the first noncomment line of the subprogram unit. 
Nonstandard source formats may confuse fsplit, ^ 

It is hard to use -e for unnamed main programs and block data subprograms since you must \ 

predict the created file name. 



( 
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NAME 

ftoc -- interface between prof and cord 

SYNOPSIS 

ftocfilel ... 

DESCRIPTION 

ftoc reads one or mor^ feedback files produced by the -feedback option of the profiler 
prof(l) and writes onto stdout a reorder-file for use with the cache-rearranging program 
cdrd(l). It interprets each feedback file as representing one phase of a program's execution. 
In other words, if a program behaves in two distinct ways depending on its input, you could 
create two different feedback files by executing the program twice with different input data, 
and both ftoc and cord will understand that the information from the first file is distinct from 
that of the second file. 

As an example, to improve the instruction-cache performance of a program called hello, you 
could generate a new hello. cord program by saying: 

cc -o hello heUo.c 

pixie -o hello .pixie hello 

hello 

prof -pixie -feedback hello. feedback hello 

ftoc hello .feedback > hello. reorder 

cord -o hello. cord hello hello .reorder 

The reorderfile consists of a Ust of lines of the form: 

sourcefile procname.procname... n 

where "procname.procname..." represents an outer-to-inner list of nested procedures, and n is 
10 times the percentage of the procedure's "density" with respect to the total of the densities 
of all procedures. ("Density" is the ratio of a procedure's total cycles to its total static iastruc- 
tions.) A line consisting of "$phase" separates information from different feedback files. 

SEE ALSO 

cord(l), prof(l) 
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NAME I 

gprof - display call graph profile data 

SYNOPSIS 

gprof [ options ] [ a.out [ gmon.out ... ] ] 

DESCRIPTION 

gprof produces an execution profile of C, Pascal, or Fortran?? programs. The effect of called 
routines is incorporated in the profile of each caller. The profile data is taken from the call 
graph profile file (gmon.out default) which is created by programs which are compiled with the 
—pg option of cc, pc, and /77. That option also links in versions of the library routines 
which are compiled for profiling. The symbol table in the named object file (a.out default) is 
read and correlated with the call graph profile file. If more than one profile file is specified, 
the gprof output shows the sum of the profile information in the given profile files. 

First, a flat profile is given, similar to that provided by prof(l). This listing gives the total exe- 
cution times and call counts for each of the functions in the program, sorted by decreasing 
time. 

Next, these times are propagated along the edges of the call graph. Cycles are discovered, 
and calls into a cycle are made to share the time of the cycle. A second fisting shows the 
functions sorted according to the time they represent including the time of their call graph des- 
cendents. Below each function entry is shown its (direct) call graph children, and how their 
times are propagated to this function. A similar display above the function shows how this 
function's time and the time of its descendents is propagated to its (direct) call graph parents. 

Cycles are also shown, with an entry for the cycle as a whole and a listing of the members of 
the cycle and their contributions to the time and call counts of the cycle. 

The following options are available: I 

—a suppresses the printing of statically declared functions. If this option is given, all 
relevant information about the static function (e.g., time samples, calls to other func- 
tions, calls from other functions) belongs to the function loaded just before the static 
function in the a.out file, 

— b supresses the printing of a description of each field in the profile. 

—c the static call graph of the program is discovered by a heuristic which examines the 
text space of the object file. Static-only parents or children are indicated with call 
counts of 0. 

— e name 

suppresses the printing of the graph profile entry for routine name and all its descen- 
dants (unless they have other ancestors that aren't suppressed). More than one ^e 
option may be given. Only one name may be given with each — e option. 

— E name 

suppresses the printing of the graph profile entry for routine name (and its descen- 
dants) as -*e, above, and also excludes the time spent in name (and its descendants) 
from the total and percentage time computations. (For example, — E mcount — E 
mcleanup is the default.) 

— f name 

prints the graph profile entry of only the specified routine name and its descendants. 
More than one —f option may be given. Only one name may be given with each "-f 
option. 

— F name 

prints the graph profile entry of only the routine name and its descendants (as "-f, • 

above) and also uses only the times of the printed routines in total time and ^ 
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percentage computations. More than o^e -F option may be given. Only one name 
may be given with each '-F option. The -F option overrides the -E option. 

a profile file gmon.sum is produced which represents the sum of the profile informa- 
tion in all the specified profile files. This summary profile file may be given to subse- 
quent executions of gprof (probably also with a -s) to accumulate profile data across 
several runs of an a, out file. 

displays routines which have zero usage (as indicated by call counts and accumulated 
time). This is useful in conjunction with the -c option for discovering which routines 
were never called. 



— s 



^z 



FILES 

a.out the namelist and text space. 

gmon.out dynamic call graph and profile. 

gmon.sum summarized dynamic call graph and profile. 

SEE ALSO 

monitor(3), profil(2), cc(l), prof(l) 

*'gprof: A Call Graph Execution Profiler", by Graham, S.L., Kessler, P.B., McKusick, M.K.; 
Proceedings of the SIGPLAN '82 Symposium on Compiler Construction, SIGPLAN Notices, 
Vol. 17, No. 6, pp. 120-126, June 1982. 



BUGS 



Beware of quantization errors. The granularity of the sampling is shown, but remains statisti- 
cal at best. We assume that the time for each execution of a function can be expressed by the 
total time for the function divided by the number of times the function is called. Thus the 
time propagated along the call graph arcs to parents of that function is directly proportional to 
the number of times that arc is traversed. 

Parents which are not themselves profiled will have the time of their profiled children pro- 
pagated to them, but they will appear to be spontaneously invoked in the call graph Usting, 
and will not have their time propagated further. Similarly, signal catchers, even though 
profiled, will appear to be spontaneous (although for more obscure reasons). Any profiled 
children of signal catchers should have their times propagated properly, unless the signal 
catcher was invoked during the execution of the profiling routine, in which case all is lost. 

The profiled program must call exit{2) or return normally for the profiling information to be 
saved in the gmon.out file. 
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NAME ^ 

graph - draw a graph 

SYNOPSIS 

graph [ option ] .., 

DESCRIPTION 

graph with no options takes pairs of numbers from the standard input as abscissas and ordi- 
nates of a graph. Successive points are connected by straight lines. The gr^ph is encoded on 
the standard output for display by the plot (IG) filters. 

If the coordinates of a point are followed by a nonnumeric string, that string is printed as a 
label beginning on the point. Labels may be surrounded with quotes ".,/', in which case they 
may be empty or contain blanks and numbers; labels never contain newlines. 

The following options are recognized, each as a separate argument, 

—a Supply abscissas automatically (they are missing from the input); spacing is given by 
the next argument (default 1). A second optional argument is the starting point for 
automatic abscissas (default or lower limit given by -^x). 

—b Break (disconnect) the graph after each label in the input. 

— c Character string given by next argument is default label for each point. 

-g Next argument is grid style, no grid, 1 frame with ticks, 2 full grid (default). 

—I Next argument is label for graph. 

—m Next argument is mode (style) of connecting lines: disconnected, 1 connected 
(default). Some devices give distinguishable line styles for other small integers. 

— s Save screen, don't erase before plotting. f 

■^x [ I ] If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x 
limits. Third argument, if present, is grid spacing on x axis. Normally these quantities 
are determined automatically. 

--y [ 1 ] Similarly for y, 

— h Next argument is fraction of space for height. 

"-W Similarly for width. 

-r Next argument is fraction of space to move right before plotting. 

-"U Similarly to move up before plotting. 

— t Transpose horizontal and vertical axes. (Option -^x now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the —s option is present. 

If a specified lower limit exceeds the upper limit, the axis is reversed. 

SEE ALSO 

spline(lG), plot(lG) 



BUGS 



graph stores all points internally and drops those for which there isn't room. 
Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 



( 
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NAME 

groups - show group memberships 

SYNOPSIS 

groups [user] 

DESCRIPTION 

The groups command showi5 the groups to which you or the optionally specified user belong. 
Each u^er belongs to a group specified in the password file /etc/passwd and possibly to other 
groups as specified in the file /etc/group . If you do not own a file but belong to the group 
which it is owned by then you are granted group access to the file. 

When a new file is created it is given the group of the containing directory. 

SEE ALSO 

setgroups(2) 

FILES 

/etc/passwd, /etc/group 

BUGS 

More groups should be allowed. 
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NAME . f 

head - give first few lines 

SYNOPSIS 

head [ —count ][ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the specified files, or of the standard input. If 
coi^/^/is omitted it defaults to 10. 

SEE ALSO 

tail(l) 



( 
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NAME 

indent - indent and format C program source 

SYNOPSIS 

indent [ input-file [ output-file ] ] [ —bad | — nbad ] [ —bap | — nbap ] [ — bbb | -nbbb ] 
[ —be I —nbc ] [ — bl | — br ] [ —en ] [ — edn ] [ — edb | — nedb ] [ — ee | —nee ] [ —em ] 
[ -Clin ] [ -dn ] [ -din ] [ -dj | -ndj ] [ -ei | -nei ] [ -fel | -nfel ] [ -in ] 
[ — ip I —nip ] [ -In ] [ -len ] [ — Ip | —nip ] [ -npro ] [ -pes | — npcs ] [ -ps | -nps ] 
[ -^psl I — npsl ] [ -sc I -nse ] [ -sob | — nsob ] [ -st ] [ -troff ] [ — v | — nv ] 

DESCRIPTION 

indent is a C program formatter. It reformats the C program in the input-file according to the 
switches. The switches which can be specified are described below. They may appear before 
or after the file names. 

NOTE: If you only specify an input-file, the formatting is done 'in-place', that is, the formatted 
file is written back into input-file and a backup copy of input-file is written in the current direc- 
tory. Jf input-file is named 7blah/blah/file% the backup file is named file.J5Ai^. 

If output-file is specified, indent checks to make sure it is different from input-file. 

OPTIONS 

The options listed below control the formatting style imposed by indent, 

"^bad,— nbad If -bad is specified, a blank line is forced after every block of declarations. 
Default: — nbad. 

—bap,— nbap If -bap is specified, a blank line is forced after every procedure body. 
Default: —nbap. 

— bbb,— nbbb If —bbb is specified, a blank line is forced before every block comment. 
Default: -nbbb, 

—be,— nbc If —be is specified, then a newline is forced after each comma in a declara- 

tion. — nbe turns off this option. The default is -nbc. 

— br,— bl Specifying — bl lines up compound statements like this: 

if(...) 
{ 

code 

} 

Specifying — br (the default) makes them look like this; 

if (...){ 

code 

} 

—en The column in which comments on code start. The default is 33. 

— edn The column in which comments on declarations start. The default is for 

these comments to start in the same column as those on code. 

—edb, —nedb Enables (disables) the placement of comment delimiters on blank lines. With 
this option enabled, comments look like this: 
/* 

* this is a comment 
*/ 
Rather than like this: 

/* this is a comment */ 
This only affects block comments, not comments to the right of code. The 
default is -edb. 
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—ce^ "^nce 



—cm 



"-^clin 



-^dn 



—din 
-fcl, -nfcl 



-1/1 

"In 

-Ip, -nip 



-^npro 

— pcs,"^npcs 

-^pSj-^nps 



Enables (disables) forcing ^else's to cuddle up to the immediately preceding 
'y. The default is — ce. 

Sets the continuation indent to be /i. Continuation lines will be indented that 
far from the beginning of the first line of the statement. Parenthesized 
expressions have extra indentation added to indicate the nesting, unless — Ip is 
in effect, -ci defaults to the same value as -i. 

Causes case labels to be indented n tab stops to the right of the containing 
switch statement. — cli0,5 causes case labels to be indented half a tab stop. 
The default is -cliO. (This is the only option that takes a fractional argu- 
ment.) 

Controls the placement of comments which are not to the right of code. 
Specifying -^dl means that such comments are placed one indentation level 
to the left of code. The default --"dO lines up these comments with the code. 
See the section on comment indentation below. 

Specifies the indentation, in character positions^ from a declaration keyword 
to the following identifier. The default is --dil6. 

-dj left justifies declarations, -ndj indents declarations the same as code. 
The default is -^iidj. 

Enables (disables) special else-if processing. If enabled, ifs following elses 
will have the same indentation as the preceding Jf statement. The default is 

•^ei. 

Enables (disables) the formatting of comments that start in column 1. Often, 
comments whose leading V is in column 1 have been carefully hand format- 
ted by the programmer. In such cases, — nfcl should be used. The default is 
-»fcl. 

The number of spaces for one indentation level. The default is 8. 

Enables (disables) the indentation of parameter declarations from the left 
margin. The default is — ip. 

Maximum length of an output line. The default is 78. 

Lines up code surrounded by parenthesis in continuation lines. If a line has a 
left paren which is not closed on that line, then continuation lines will be 
lined up to start at the character position just after the left paren. For exam- 
ple, here is how a piece of continued code looks with "^nlp in effect: 

pi = first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
With "^Ip in effect (the default) the code looks somewhat clearer: 

pi - first_procedure(second_procedure(p2, p3), 
third_procedure(p4, p5)); 
Inserting two more newlines we get: 

pi == first_procedure(second_procedure(p2, 

P3), 
third_procedure(p4 , 

p5)); 

Causes the profile files, *./. indent. pro' and '7Jndent.pro', to be ignored. 

If true (—pes) all procedure calls will have a space inserted between the name 
and the '{\ The default is — npcs. 

If true (— ps) the pointer following operator '->' will be surrounded by spaces 
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— psl,— npsl 



-^sc,— nsc 



-sob,— nsob 



-St 

'"Ttypename 



-troff 



— Vj-^nv 



on either side. The default is -nps. 

If true (-psl) the names of procedures being defined are placed in column 1 
~ their types, if any, will be left on the previous lines. The default is -psl. 

Enables (disables) the placement of asterisks {'*'s) at the left edge of all com- 
ments. The default is — sc. 

If -sob is specified, indent will swallow optional blank lines. You can use 
this to get rid of blank fines after declarations. Default: -nsob. 

Causes indent to take its input from stdin, and put its output to stdout. 

Adds typename to the fist of type keywords. Names accumulate: -T can be 
specified more than once. You need to specify all the typenames that appear 
in your program that are defined by typedefs - nothing will be harmed if you 
miss a few, but the program won't be formatted as nicely as it should. This 
sounds like a painful thing to have to do, but it's really a symptom of a prob- 
lem in C: typedef causes a syntactic change in the language and indent can't 
find all typedefs. 

Causes indent to format the program for processing by troff . It will produce a 
fancy listing in much the same spirit as vgrind. If the output file is not 
specified, the default is standard output, rather than formatting in place. 

-V turns on Verbose' mode; — nv turns it off. When in verbose mode, indent 
reports when it splits one line of input into two or more lines of output, and 
gives some size statistics at completion. The default is — nv. 

FURTHER DESCRIPTION 

You may set up your own 'profile' of defaults to indent by creating a file called .indent. pro in 
either your login directory and/or the current directory and including whatever switches you 
like. Switches in *.indent.pro' in the current directory override those in your login directory 
(with the exception of -T type definitions, which just accumulate). If indent is run and a 
profile file exists, then it is read to set up the program's defaults. The switches should be 
separated by spaces, tabs or newlines. Switches on the command line, however, override 
profile switches. 

Comments 

'Box' comments, indent assumes that any comment with a dash or star immediately after the 
start of comment (that is, 7*-' or 7**') is a comment surrounded by a box of stars. Each line 
of such a comment is left unchanged, except that its indentation may be adjusted to account 
for the change in indentation of the first line of the comment. 

Straight text. Afi other comments are treated as straight text, indent fits as many words 
(separated by blanks, tabs, or newlines) on a line as possible. Blank lines break paragraphs. 

Comment indentation 

If a comment is on a line with code it is started in the 'comment column', which is set by the 
— c/2 command fine parameter. Otherwise, the comment is started at n indentation levels less 
than where code is currently being placed, where n is specified by the -d/z command line 
parameter. If the code on a line extends past the comment column, the comment starts 
further to the right, and the right margin may be automatically extended in extreme cases. 

Preprocessor lines 

In general, indent leaves preprocessor lines alone. The only reformatting that it will do is to 
straighten up trailing comments. It leaves embedded comments alone. Conditional compila- 
tion (#ifdef...#endif) is recognized and indent attempts to correctly compensate for the syn- 
tactic pecufiarities introduced. 
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C syntax 

indent understands a substantial amount about the syntax of C, but it has a 'forgiving' parser. 
It attempts to cope with the usual sorts of incomplete and misformed syntax. In particular, 
the use of macros like: 

#define forever for(;;) 
is handled properly. 



fii.es 



BUGS 



./.indent. pro profile file 
Y.indent.pro profile file 

mrfmf has even more switches than /i^. 

A common mistake that often causes grief is typing: 

indent *,c 
to the shell in an attempt to indent all the C programs in a directory. This is probably a bug, 
not a feature. 



( 
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NAME 

kill - terminate a process with extreme prejudice 

SYNOPSIS 

kill [ — sig ] processid ... 
kill -1 

DESCRIPTION 

kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or 
number preceded by *-' is given as first argument, that signal is sent instead of terminate (see 
sigvec{2)). The signal names are listed by 'kill -1', and are as given in /usr /include/ signaLh, 
stripped of the common SIG prefix. 

The terminate signal will kill processes that do not catch the signal; 'kill -9 ...' is a sure kill, 
as the KILL (9) signal cannot be caught. By convention, if process number is specified, all 
members in the process group (i.e. processes resulting from the current login) are signaled 
(but beware: this works only if you use sh{t)] not if you use csh{V).) Negative process numbers 
also have special meanings; see kill{2) for details. 

The killed processes must belong to the current user unless he is the super-user. 

The process number of an asynchronous process started with *&' is reported by the shell. Pro- 
cess numbers can also be found by using p5(l). kill is a built-in to csh{l)\ it allows job 
specifiers of the form "%,.." as arguments so process id's are not as often used as kill argu- 
ments. See c^/z(l) for details. 

SEE ALSO 

csh(l), ps(l), kiU(2), sigvec(2) 

BUGS 

A replacement for "kill 0'' for ci'/z(l) us^rs should be provided. 
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NAME 

last - indicate last logins of users and teletypes 

SYNOPSIS 

IsLst [ -N ]['^si][ name.., ][tty...] 

DESCRIPTION 

last win look back in the wtmp file which records all logins and logouts for information about 
a. user, a teletype or any group of users and teletypes. Arguments specify names of users or 
teletypes of interest. Names of teletypes may be given fully or abbreviated. For example 'last 
0' is the same as last ttyO'. If multiple arguments are given, the information which appHes to 
any of the arguments is printed. For example 'last root console^ would Ust all of "root's" ses- 
sions as well as all sessions on the console terminal, last will print the sessions, of the 
specified users and teletypes, most recent first, indicating the times at which the session 
began, the duration of the session, and the teletype which the session took place on. If the 
session is still continuing or was cut short by a reboot, last so indicates. 

The pseudo-user reboot logs in at reboots of the system, thus 

last reboot 

will give an indication of mean time between reboot. 

If last is interrupted, it indicates how far the search has progressed in wtmp. li interrupted 
with a quit signal (generated by a controlA) last indicates how far the search has progressed so 
far, and the search continues. 

OPTIONS 

-A^ By default, all logins and logouts that match are printed. This option limits the report to 
iV lines. 

-a Print information from all data base files. By default, the report only includes data from 
/usr/adm/wtmp, which only applies to the last current period (usually a month). The -a 
option tells last to get data from wtmp.O, wtmp J ^ and so forth. 

FILES 

/usr/adm/wtmp* login data base files 

/usr/adm/shutdownlog which records shutdowns and reasons for same 

SEE ALSO 

wtmp(5), ac(8), lastcomm(l) 

AUTHOR 

Howard Katseff 

BUGS 

The —a option causes last to look at wtmp, wtmp.O, wtmp.l, and so forth, but it stops as soon 
as it finds a missing file, so if there is a wtmp.5 but no wtmp.4, processing stops with wtmp. 3. 
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NAME 

lastcomm -- show last commands executed in reverse order 

SYNOPSIS 

lastcomm [ command name ] ... [user name] ... [terminal name] ... 

DESCRIPTION 

lastcomm gives information on previously executed commands. With no arguments, lastcomm 
prints information about all the commands recorded during the current accounting file's life- 
time. If called with arguments, only accounting entries with a matching command name, user 
name, or terminal name are printed. So, for example, 

lastcomm a.out root ttydO 
would produce a Usting of all the executions of commands named a.out by user root on the 
terminal ttydO. 

For each process entry, the following are printed. 
The name of the user who ran the process. 
Flags, as accumulated by the accounting facilities in the system. 
The command name under which the process was called. 
The amount of cpu time used by the process (in seconds). 
The time the process exited. 

The flags are encoded as follows: "S" indicates the command was executed by the super-user, 
"F" indicates the command ran after a fork, but without a following ei^ee, *'C'' indicates the 
command was run in PDP-11 compatibility mode (VAX only), *'D" indicates the command 
terminated with the generation of a. core file, and "X" indicates the command was terminated 
with a signal. 

FILES 

/usr/adm/acct 

SEE ALSO 

last(l), sigvec(2), acct(8), core(5) 
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NAME 

Id - MIPS link editor 
uld - ucode link editor 



( 



SYNOPSIS 

Id [ option ] ... file ... 
uld [ option ] ... file ... 

DESCRIPTION 

Ld, the MIPS link editor, runs on MIPS machines under the UNIX system "4. 3bsd and System 
V. It links MIPS extended coff object files. The archive format understood by Id is the one 
created by the MIPS archiver ar{V), 

The W command combines several object files into one, preforms relocation, resolves external 
symbols, and supports symbol table information for symboUc debugging. In the simplest case, 
the names of several object jfzto are given. Ld combines them, producing an object module 
that can be executed or used as input for a subsequent Id run. (In the latter case, the -r 
option must be given to preserve the relocation entries.) The output of Id is left in a,out. By 
default, this file is executable if no errors occurred during the load. 

The argument object files are concatenated in the order specified. The entry point of the out- 
put is the beginning of the text segment (unless the --e option is specified). 

The wM command combines several ucode object files and libraries into one ucode object file. 
It "hides" external symbols for better optimizations by subsequent compiler passes. The sym- 
bol tables of coff object files loaded with ucode object files are used to determine what exter- 
nal symbols not to "hide" along with files specified by the user that contain Hsts of symbol 
names. 

If any argument is a library, it is searched exactly once at the point it is encountered in the • 

argument list. Only those routines defining an unresolved external reference are loaded. The ^ 

library (archive) symbol table (see ar(l)) is a hash table and is searched to resolved external 
references that can be satisfied by library members. The ordering of library members is unim- 
portant. 

The following options are recognized by both Id and uld . Those options used by one and not 
the other are ignored. Any option can be preceded by a 'k' (for example -ko outfile) and 
except for — kb; have the same meaning with or without the preceding V. This is done so that 
these options can be passed to both Hnk editors through compiler drivers. 

When searching for libraries the default directories searched are /lib/, /usr/lib/cmplrs/cc, 
/usr/lib/ and /usr/local/lib/ . If the target byte ordering of the object files being loaded is of 
the opposite byte ordering of the machine the link editor is running on then the default search 
directories for libraries are changed. The change is to replace the last name of the directories 
from "lib/" to "libeb/" or "libel/" to match the target byte ordering of the objects being 
loaded. 

The symbols 'etext', 'edata', 'end', *_ftext', Lfdata', '„fbss', '_gp', *„procedure_table', 
'_procedure_table_size' and Lprocedure_string__table' are reserved. These loader defined sym- 
bols if referred to, are set their values as described in end(^). It is erroneous to define these 
symbols. 

— o outfile 

Produce an output object file by the name outfile. The name of the default object file 
is a. out. 

•-L^ Search a library libj.a, where x is a string. A library is searched when its name is 
encountered, so the placement of a —1 is significant. 

—kk Search a library lib;t.b, where x is a string. These libraries are intended to be ucode 
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object libraries. In all other ways, this option is like the -k option. 

^hdir Change the algorithm of searching for libx.a or libj^.b to look in dir before looking in 
the default directories. This option is effective only if it precedes the -1 options on 
the command line. 

*-L Change the algorithm of searching for libx.a or libx.b to never look in the default 
directories. This is useful when the default directories for libraries should not be 
searched and only the directories specified by -Ld/r are to be searched. 

r-Kdir Change the default directories to the single directory dir. This option is only intended 
to be used by the compiler driver. Users should use the -L and — Lrf/r options to get 
the effect they desire. 

-Barring 

Append string to the library names created for the -Lc and -kb: when searching for 
library names. For each directory to be searched the name is first created with the 
string and if it is not found it is created without the string. 

-p file Preserve (don't '^hide'') the symbol names Usted in file when loading ucode object 
files. The symbol names in the file are separated by blanks, tabs, or newlines. 

•^s Strip the symbolic information from the output object file. 

-X Do not preserve local (non-.globl) symbols in the output symbol table; enter external 
and static symbols only. This option saves some space in the output file. 

-r Retain relocation entries in the output file. Relocation entries must be saved if the 
output file is to become an input file in a subsequent Id run. This option also prevents 
final definitions from being given to common symbols, and suppresses the ^undefined 
symboF diagnostics. 

'-d Force definition of common storage and define loader defined symbols even if -r is 
present. 

— u symname 

Enter symname as an undefined in the symbol table. This is useful for loading entirely 
from a library, since initially the symbol table is empty and an unresolved reference is 
needed to force the loading of the first routine. 

-F or -z 

Arrange for the process to be loaded on demand from the resulting executable file 
(413 format) rather than preloaded, a ZMAGIC file. This is the default. 

^n Arrange (by giving the output file a 0410 "magic number") that when the output file is 
executed, the text portion will be read-only and shared among all users executing the 
file, an NMAGIC file. This involves moving the data areas up to the first possible 
pagesize byte boundary following the end of the text. 

— N Place the data section immediately after the text and do not make the text portion 
read only or sharable, an OMAGIC file. (Use "magic number" 0407.) 

—T num 

Set the text segment origin. The argument num is a hexadecimal number. See the 
notes section for restrictions. 

— D num 

Set the data segment origin. The argument num is a hexadecimal number. See the 
notes section for restrictions. 

— B num 

Set the bss segment origin. The argument num is a hexadecimal number. This option 



Page 2 February 13, 1989 MIPS Computer Systems, Inc. 



LD ( 1 ) RISC/os Programmer's Reference LD ( 1 ) 



can be used only if the final object is an OMAGIC file. 

—e epsym 

Set the default entry point address for the output file to be that of the symbol epsym. 

—m Produce a map or listing of the input/output sections on the standard output (UNIX 
system V-like map). 

— M Produce a primitive load map, Hsting the names of the files that will be loaded (UNIX 
4.3bsd-like map). 

-"S Set silent mode and suppress non-fatal errors. 

—v Set verbose mode. Print the name of each file as it is processed. 

—ysym Indicate each file in which sym appears, sym^s type and whether the file defines or 
references sym. Many such options may be given to trace many symbols. 

—V Print a message giving information about the version of Id being used. 

— VS num 

Use num as the decimal version stamp to identify the a. out file that is produced, The 
version stamp is stored in the optional and symbolic headers. 

—f fill Set the fill pattern for '^holes'' within an output section. The argument /?// is a four- 
byte hexadecimal constant. 

— G num 

The argument num is taken to be a decimal number that is the largest size, in bytes of 
a .comm item or literal that is to be allocated in the small bss section for reference off 
the global pointer. The default is 8 bytes. 

■-bestGnum 

Calculate the best — G num to use when compiling and linking the files which pro- 
duced the objects being linked. Using too large a number with the — G num option 
may cause the gp (global-pointer) data area to overflow; using too small a number may 
reduce your program's execution speed. 

—count, "-nocount, —countall 

These options control which objects are counted as recompilable for the best "--G num 
calculation. By default, the — bestGnum option assumes you can recompile everything 
with a different — G num option. If you cannot recompile certain object files or 
libraries (because, for example, you have no sources for them), use these options to 
tell the link editor to take this into account in calculating the best —G num value. 
— nocount says that object files appearing after it on the command line cannot be 
recompiled; —count says that object files appearing after it on the command line can 
be recompiled; you can alternate the use of ---nocoiint and —count. — countall over- 
rides any — nocount options appearing after it on the command line. 

— b Do not merge the symbolic information entries for the same file into one entry for that 
file. This is only needed when the symbolic information from the same file appears 
differently in any of the objects to be linked. This can occur when object files are 
compiled, by means of conditional compilation, with an apparently different version 
of an include file. 

— jmpopt and —nojmpopt 

Fill or don't fill the delay slots of jump instructions with the target of the jump and 
adjust the jump offset to jump past that instruction. This allways is disabled for 
debugging (when the -gl^ -g2 or -g flag is present). When this option is enabled it 
requires that all of the loaded program's text be in memory and could cause the loader 



to run out of memory. 



c 



c 



oaaea program s text be m memory ana could cause the loader g 

The default is -nojpmpopt. ^ 
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-gor-g[0123] 

These options are accepted and except for — gl, — g2 or — g disabling the —jmpopt 
have no other effect. 

—A file This option specifies incremental loading, i.e. linking is to be done in a manner so 
that the resulting object may be read into an already executing program. The next 
argument, file, is the name of a file whose symbol table will be taken as a basis on 
which to define additional symbols. Only newly linked material will be entered into 
the text and data portions of a.out, but the new symbol table will reflect every symbol 
defined before and after the incremental load. This argument must appear before any 
other object file in the argument list. The — T option may be used as well, and will be 
taken to mean that the newly linked segment will commence at the corresponding 
address (which must be a correct multiple for the resulting object type). The default 
resulting object type is an OMAGIC file and the default starting address of the text is 
the old value of end rounded to SCNROUND as defined in the include file 
<scnhdr,h>. Using the defaults, when this file is read into an already executing pro- 
gram the intial value of the break must also be rounded. All other objects except the 
argument to the —A option must be compiled — G and this sets — G for linking. 

The following options are used by the command mkshlib (1) and are not intended for general 
use. 

-c Create a target shared library object file. This is a LEBMAGIC file (443 format). The 
objects linked must be compiled with —G and this sets — G for. linking. This file is 
demand paged and the headers are part of the text but on there own page so real text 
starts on the next page where the text is loaded. 

—{file The .text section of file is moved into the .init section of the resulting object file. 

Ld and uld accept object files targeted for either byte ordering with their headers and symbolic 
tables in any byte ordering; however Id and uld are faster if the headers and symbolic tables 
have the byte ordering of the machine that they are running on. The default byte ordering of 
the headers and symbolic tables is the target byte ordering of the output object file. For non- 
relocatable object files the default byte ordering of the headers and symboHc tables can't be 
changed. 

— EB Produce the output object file with big-endian byte ordered headers and symbolic 
information tables. 

—EL Produce the output object file with little-endian byte ordered headers and symbolic 
information tables. 



FILES 



/lib/lib*, a 
/usr/lib/lib*.a 

/usr/local/lib/lib>ic.a libraries 
a. out output file 

SEE ALSO 

cc(l), pc(l), f77(l), as(l), ar(l) 

NOTES 

Any of the three types of objects can be run on UMIPS-BSD or UMIPS-V systems. On both 
systems the segments must not overlap and all addresses must be less than 0x80000000. The 
stack starts below 0x80000000 and grows through lower addresses so space should be left for 
it. For ZMAGIC and NMAGIC files the default text segment address is 0x00400000 and the 
default data segment address is 0x10000000. For OMAGIG files the default text segment 
address is 0x10000000 with the data segment following the text segment. The default for all 



Page 4 February 13, 1989 MIPS Computer Systems, Inc. 



U) ( 1 ) RISC/os Programmer's Reference LD ( 1 ) 



types of files is that the bss i^egment follows the data segment. 

For OMAQIC files to be run under the operating system the -B flag should not be used 
because the bss segment must follow the data i^egment which is the default. 

Under UMIPS^BSD the segments must be on 4 megabyte boundaries, Objects linked at 
addresses other than the default will run under the 2.0 and later UMIPS-BSD releases. 

Under UMIPS-V the segments muist be on 2 megabyte boundaries. OMAGIC files will run 
under the hi and later UMIPS-V releases, 



( 



( 
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NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [ ['¥]hhmm ] 

DESCRIPTION 

leave waits until the specified time, then reminds you that you have to leave. You are rem- 
inded 5 minutes and 1 minute before the actual time, at the time, and every minute thereafter. 
When you log off, leave exits just before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour clock). 
All times are converted to a 12 hour clock, and assumed to be in the next 12 hours. 

If the time is preceeded by *+', the alarm will go off in hours and minutes from the current 
time. 

If no argument is given, leave prompts with "When do you have to leave?". A reply of newline 
causes leave to exit, otherwise the reply is assumed to be a time. This form is suitable for 
inclusion in a Jogin or .profile, 

leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or use 
"kill -9" giving its process id. 

If leave is executed within the script (1) or window(l) command, it prints the message "Unre- 
gistered login" and aborts. This is because the only way leave can tell if you have logged out is 
to look at the login resgistry information for the port in the file letc/utmp^ and these com- 
mands do not register the port. 

SEE ALSO 

calendar(l) 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



LINT(l) RISC/os Programmer's Reference LINT(l) 



c 



( 



NAME 

lint - a C program checker 

SYNOPSIS 

lint [ option ] ... file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files that are likely to be bugs, non-portable, 
or wasteful. It also checks type usage more strictly than the compilers. Among the things 
that are currently detected are unreachable statements, loops not entered at the top, automatic 
variables declared and not used, and logical expressions whose value is constant. Moreover, 
the usage of functions is checked to find functions that return values in some places and not 
in others, functions called with varying numbers or types of arguments, and functions whose 
values are not used or whose values are used but none returned. 

Arguments whose names end with .c are taken to be C source files. Arguments whose names 
end with .In are taken to be the result of an earlier invocation of lint with either the —c or the 
— o option used. The .In files are analogous to .o (object) files that are produced by the cc(l) 
command when given a .c file as input. Files with other suffixes are warned about and 
ignored. 

Lint will take all the .c,.ln, and llib-k.ln (specified by --he) files and process them in their 
command line order. By defauk, lint appends the standard C lint library (llib-lcjn) to the end 
of the Ust of files. However, if the --p option is used, the portable C lint library (llib-port.ln) 
is appended instead. When the ---c option is not used, the second pass of lint checks this list 
of files for mutual compatibility. When the — c option is used, the .In and the llib-lx Jn files 
are ignored. 

Any number of lint options may be used, in any order, intermixed with file-name arguments. 
The following options are used to suppress certain kinds of complaints: 

—a Suppress complaints about assignments of long values to variables that are not long. 

--"b Suppress complaints about break statements that cannot be reached. (Programs pro- 
duced by lex or y ace will often result in many such complaints). 

—h Do not apply heuristic tests that attempt to intuit bugs, improve style, and reduce 
waste. 

— u Suppress complaints about functions and external variables used and not defined, or 
defined and not used. (This option is suitable for running lint on a subset of files of a 
larger program). 

—V Suppress conlplaints about unused arguments in functions. 

-"X Do not report variables referred to by external declarations but never used. 

The following arguments alter lint^s behavior: 

"^Lc Include additional lint library llib-b;.ln. For example, you can include a lint version of 
the Math Library llib-lm.ln by inserting — Im on the command line. This argument 
does not suppress the default use of Uib-lc.ln. These lint libraries must be in the 
assumed directory. This option can be used to reference local lint libraries and is use- 
ful in the development of multi-file projects. 

— n Do not check compatibility against either the standard or the portable lint library, 

—p Attempt to check portability to other dialects (IBM and GCOS) of C. Along with 
stricter checking, this option causes all non-external names to be truncated to eight 
characters and all external names to be truncated to six characters and one case. 

"-c Cause lint to produce a Jn file for every .c file on the command line. These .In files I 
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are the product of /mr's first pass only, and are not checked for mter-f unction compa- 
tibility. 

-o lib Cause lint to create a lint library with the name llihAUbAn. The -c option nullifies 
any use of the -o option. The lint library produced is the input that is given to lint^s 
second pass. The -o option simply causes this file to be saved in the named lint 
library. To produce a llib-l//&.ln without extraneous messages, use of the -x option is 
suggested. The -v option is useful if the source file(s) for the lint library are just 
external interfaces (for example, the way the file llib-lc is written). These option set- 
tings are also available through the use of "lint comments" (see below). 

The -D, -U, and -I options of cpp{l) and the -g and -O options of cc(l) are also recog- 
nized as separate arguments. The -g and -O options are ignored, but, by recognizing these 
options, lint's behavior is closer to that of the cc{l) command. Other options are warned 
about and ignored. The pre-processor symbol "lint" is defined to allow certain questionable 
code to be altered or removed for lint. Therefore, the symbol "lint" should be thought of as 
a reserved word for all code that is planned to be checked by lint. 

Certain conventional comments in the C source will change the behavior of lint: 

/*NOTREACHED*/ 

at appropriate points stops comments about unreachable code. (This com- 
ment is typically placed just after calls to functions like exit (2)). 

/^VARARGSn*/ 

suppresses the usual checking for variable numbers of arguments in the follow- 
ing function declaration. The data types of the first n arguments are checked; 
a missing n is taken to be 0. 

AARGSUSED*/ 

turns on the -™v option for the next function. 

/*LINTLIBRARY*/ 

at the beginning of a file shuts off complaints about unused functions and 
function arguments in this file. This is equivalent to using the -v and -x 
options. 

Lint produces its first output on a per-source-file basis. Complaints regarding included files 
are collected and printed after all source files have been processed. Finally, if the -c option 
is not used, information gathered from all input files is collected and checked for consistency. 
At this point, if it is not clear whether a complaint stems from a given source file or from one 
of its included files, the source file name will be printed followed by a question mark. 

The behavior of the --c and the -o options allows for incremental use of lint on a set of C 
source files. Generally, one invokes lint once for each source file with the -c option. Each 
of these invocations produces a .In file which corresponds to the .c file, and prints all mes- 
sages that are about just that source file. After all the source files have been separately run 
through linty it is invoked once more (without the -c option), listing all the .In files with the 
needed -U options. This will print all the inter-file inconsistencies. This scheme works well 
with make{l); it allows make to be used to lint only the source files that have been modified 
since the last time the set of source files were lintQd. 



FILES 



/usr/lib the directory where the Hnt libraries specified by the -be option must exist 

/usr/lib/lint[12] first and second passes 

/usr/lib/llib-lc.hi declarations for C Library functions (bmary format; source is in 

/usr/lib/Uib-lc) 
/usr/lib/Uib-port.ln declarations- for portable functions (binary format; source is in 

/usr/lib/Uib-port) 
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/usr/lib/Uib-lm.to declarations for Math Library functions (binary format; source is in 

/usr/lib/Ilib^lm) 
/usr/tmp/4intxc temporaries 

SEE ALSO 

cc(l), cpp(l), make(l). 

BUGS 

exit(2), longjmpiSC), and other functions that do not return are not understood; this causes 
various lies. 
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NAME 

In - make links 

SYNOPSIS 

In [ — s ] sourcename [ targetname ] 

In [ — s ] sourcenamel sourcename2 [ sourcenameS ,.. ] targetdirectory 

DESCRIPTION 

A link is a directory entry referring to a file; the same file (together with its size, all its protec- 
tion information, etc.) m?Ly have several links to it. There are two kinds of links: hard links 
and symboHc links. 

By default In makes hard links. A hard link to a file is indistinguishable from the original 
directory entry; any changes to a file are effective independent of the name used to reference 
the file. Hard Unks may not span file systems and may not refer to directories. 

The — s option causes In to create symbolic links. A symbolic link contains the name of the 
file to which it is linked. The referenced file is used when an open (2) operation is performed 
on the link. A stat{2) on a symbolic link will return the linked-to file; an lstat(2) must be 
done to obtain information about the link. The readlink(2) call may be used to read the con- 
tents of a symboUc link. Symbolic links may span file systems and may refer to directories. 

Given one or two arguments, In creates a link to an existing file sourcename . If targetname is 
given, the link has that name; targetname may also be a directory in which to place the link; 
otherwise it is placed in the current directory. If only the directory is specified, the link will 
be made to the last component of sourcename . 

Given mpre than two arguments, In makes links in targetdirectory to all the named source 
files. The links made will have the same name as the files being linked to. 

SEE ALSO 

rm(l), cp(l), mv(l), link(2), readlink(2), stat(2), symlink(2) 
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NAME \ 

look - find lines in a sorted list 

SYNOPSIS 

look [ --df] string [file] 

DESCRIPTION 

look consults a sorted file and prints all lines that begin with strings It uses binary search. 

The options d and f affect comparisons as in ^ort(l); 

d 'Dictionary' order: only letters, digits, tabs and blanks participate in comparisons. 

f Fold, Upper case letters compare equal to lower cas^f 

If no file is specified, /usr I diet /words is assumed with collating sequence ^dt 

FILES 

/usr/dict/words 

SEE ALSO 

sort(l), grep(l) 



( 
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NAME 

indxbib, lookbib - build inverted index for a bibliography, find references in a bibliography 

SYNOPSIS 

indxbib database . . . 
loolcbib [ — n ] database 

DESCRIPTION 

Indxbib makes an inverted index to the named databases (or files) for use by lookbib (1) and 
refer (1). These files contain bibliographic references (or other kinds of information) 
separated by blank lines. 

A bibliographic reference is a set of lines, constituting fields of bibliographic information. 
Each field starts on a line beginning with a "%", followed by a key-letter, then a blank, and 
finally the contents of the field, which may continue until the next line starting with "%". 

Indxbib is a shell script that calls /usr/lib/refer/mkey and /usr/lib/refer/inv. The first pro- 
gram, mkey, truncates words to 6 characters, and maps upper case to lower case. It also dis- 
cards words shorter than 3 characters, words among the 100 most common English words, 
and numbers (dates) < 1900 or > 2000. These parameters can be changed; see page 4 of the 
Refer document by Mike Lesk. The second program, inv, creates an entry file (.ia), a posting 
file (.ib), and a tag file (.ic), all in the working directory. 

lookbib uses an inverted index made by indxbib to find sets of bibliographic references. It 
reads keywords typed after the ">" prompt on the terminal, and retrieves records containing 
all these keywords. If nothing matches, nothing is returned except another ">" prompt. 

lookbib will ask if you need instructions, and will print some brief information if you reply 
"y". The **-n" flag turns off the prompt for instructions. 

It is possible to search multiple databases, as long as they have a common index made by 
indxbib. In that case, only the first argument given to indxbib is specified to lookbib. 

K lookbib does not find the index files (the .i[abc] files), it looks for a reference file with the 
same name as the argument, without the suffixes. It creates a file with a Mg' suffix, suitable 
for use with fgrep. It then uses this fgrep file to find references. This method is simpler to 
use, but the .ig file is slower to use than the .i[abc] files, and does not allow the use of multi- 
ple reference files. 

FILES 

x.ia, jc.ib, x.ic, where x is the first argument, or if these are not present, then ;t.ig, x 

SEE ALSO 

refer(l), addbib(l), sortbib(l), roffbib(l), lookbib(l) 

BUGS 

Probably all dates should be indexed, since many disciplines refer to literature written in the 
1800s or earlier. 
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NAME 

Ipq - spool queue examination program 

SYNOPSIS 

Ipq [ +[ n ] ] [ -1 ] [ -Pprinter ] [ job # ... ] [ user ... ] 

DESCRIPTION 

Ipq examines the spooling area used by lpd{S) for printing files on the line printer, and reports 
the status of the specified jobs or all jobs associated with a user. Ipq invoked without any argu- 
ments reports on any jobs currently in the queue. A — P flag may be used to specify a particu- 
lar printer, otherwise the default line printer is used (or the value of the PRINTER variable in 
the environment). If a + argument is supplied, Ipq displays the spool queue until it empties. 
Supplying a number immediately after the -f sign indicates that Ipq should sleep n seconds in 
between scans of the queue. AH other arguments supplied are interpreted as user names or 
job numbers to filter out only those jobs of interest. 

For each job submitted (i.e. invocation of lpr{l)) Ipq reports the user's name, current rank in 
the queue, the names of files comprising the job, the job identifier (a number which may be 
supplied to lprm{l) for removing a specific job), and the total size in bytes. The -1 option 
causes information about each of the files comprising the job to be printed. Normally, only as 
much information as will fit on one line is displayed. Job ordering is dependent on the algo- 
rithm used to scan the spooling directory and is supposed to be FIFO (First in First Out) . File 
names comprising a job may be unavailable (wheii lpr{l) is used as a sink in a pipeUne) in 
which case the file is indicated as "(standard input)". 

If Ipq warns that there is no daemon present (i.e. due to some malfunction), the lpc{S) com- 
mand can be used to restart the printer daemon. 

FILES 

/etc/termcap for manipulating the screen for repeated display 

/etc/printcap to determine printer characteristics 

/usr/spool/* the spooling directory, as determined from printcap 

/usr/spool/*/cf* control files specifying jobs 

/usr/spool/nc/lock the lock file to obtain the currently active job 

SEE ALSO 

Ipr(l), Iprm(l), lpc(8), lpd(8) 

BUGS 

Due to the dynamic nature of the information in the spooling directory Ipq may report unreli- 
ably. Output formatting is sensitive to the line length of the terminal; this can results in 
widely spaced columns. 

DIAGNOSTICS 

Unable to open various files. The lock file being malformed. Garbage files when there is no 
daemon active, but files in the spooling directory. 
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NAME 

Ipr - off line print 

SYNOPSIS 

Ipr [ -Fprinter ] [ -#num ] [ -C class ] [ --J job ] [ -T title ] [ -i [ numcols ]] [ -1234 font ] [ 
'-vfnum ] [ -pltndgvcfrmhs ] [ name ... ] 

DESCRIPTION 

Ipr uses a spooling daemon to print the named files when faciUties become available. If no 
names appear, the standard input is assumed. The -P option may be used to force output to 
a specific printer. Normally, the default printer is used (site dependent), or the value of the 
environment variable PRINTER is used. 

The following single letter options are used to notify the line printer spooler that the files are 
not standard text files. The spooling daemon will use the appropriate filters to print the data 
accordingly. 

-p Use pr(l) to format the files (equivalent to print), 

—1 Use a filter which allows control characters to be printed and suppresses page breaks. 

-t The files are assumed to contain data from trojf{l) (cat photo typesetter commands). 

-n The files are assumed to contain data from ditrojf (device independent troff). 

-d The files are assumed to contain data from tex{l) (DVI format from Stanford). 

-g The files are assumed to contain standard plot data as produced by the plot{3X) routines 
(see also plot (IG) for the filters used by the printer spooler). 

—v The files are assumed to contain a raster image for devices like the Benson Varian. 

— c The files are assumed to contain data produced by cifplot(l). 

-f Use a filter which interprets the first character of each line as a standard FORTRAN car- 
riage control character. 

The remaining single letter options have the following meaning. 

-r Remove the file upon completion of spooling or upon completion of printing (with the 
— s option). 

— m Send mail upon completion. 

— h Suppress the printing of the burst page. 

—s Use symbolic links. Usually files are copied to the spool directory. 

The —C option takes the following argument as a job classification for use on the burst page. 
For example, 

Ipr -C EECS foo.c 

causes the system name (the name returned by hostname (1)) to be replaced on the burst page 
by EECS, and the file foo.c to be printed. 

The —J option takes the foUowmg argument as the job name to print on the burst page. Nor- 
mally, the first file's name is used. 

The -T option uses the next argument as the title used by pr{l) instead of the file name. 

To get multiple copies of output, use the "if^num option, where num is the number of copies 
desired of each file named. For example, 

Ipr -#3 foo.c bar.c more.c 
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would result in 3 copies of the file foo.c, followed by 3 copies of the file bar.c, etc. On the 
other hand, 

cat foo.c bar.c more.c | Ipr -#3 

will give three copies of the concatenation of the files. 

The -i option causes the output to be indented. If the next argument is numeric, it is used as 
the number of blanks to be printed before each line; otherwise, 8 characters are printed. 

The -w option takes the immediately following number to be the page width for pr. 

The "»s option will use symlink{2) to link data files rather than trying to copy them so large 
files can be printed. This means the files should not be modified or removed until they have 
been printed. 

The option -1234 Specifies a font to be mounted on font position i. The daemon will con- 
struct a .railmag file referencing lusr/lih/vfontl name, size. 



( 



FILES 



/etc/passwd personal identification 

/etc/printcap printer capabilities data base 

/usr/lib/lpd* line printer daemons 

/usr/spool/* directories used for spooling 

/usr/spool/*/cf* daemon control files 

/usr/spool/*/df* data files specified in "cf ' files 

/usr/spool/*/tf* temporary copies of "cf ' files 

SEE ALSO 

Ipq(l), Iprm(l), pr(l), symlink(2), printcap(5), lpc(8), lpd(8) 

DIAGNOSTICS V 

If you try to spool too large a file, it will be truncated. Ipr will object to printing binary files. 
K a user other than root prints a file and spooling is disabled, Ipr will print a message saying 
so and will not put jobs in the queue. If a connection to Ipd on the local machine cannot be 
made, Ipr will say that the daemon cannot be started. Diagnostics n^^ay be printed in the 
daemon's log file regarding missing spool files by Ipd, 



BUGS 



Fonts for trpff and tex reside on the host with the printer. It is currently not possible to use 
local font libraries. 



( 
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NAME 

Iprm - remove jobs from the line printer spooling queue 

SYNOPSIS 

Iprm [ -^Fprinter ] [ — ] [ job # ... ] [ user ... ] 

DESCRIPTION 

Iprm will remove a job, or jobs, from a printer's spool queue. Since the spooling directory is 
protected from users, using Iprm is normally the only method by which a user may remove a 
job. 

Iprm without any arguments will delete the currently active job if it is owned by the user who 
invoked Iprm . 

If the — flag is specified, Iprm will remove all jobs which a user owns. If the super-user 
employs this flag, the spool queue will be emptied entirely. The owner is determined by the 
user's login name and host name on the machine where the Ipr command was invoked. 

Specifying a user's name, or Ust of user names, will cause Iprm to attempt to remove any jobs 
queued belonging to that user (or users). This form of invoking Iprm is useful only to the 
super-user. 

A user may dequeue an individual job by specifying its job number. This number may be 
obtained from th^ lpq(l) program, e.g. 

% Ipq -i 

1st: ken [job #013ucbarpa] 

(standard input) 100 bytes 

% Iprm 13 

Iprm will announce the names of any files it removes and is silent if there are no jobs in the 
queue which match the request Hst. 

Iprm will kill off an active daemon, if necessary, before removing any spooling files. If a dae- 
mon is killed, a new one is automatically restarted upon completion of file removals. 

The — P option may be usd to specify the queue associated with a specific printer (otherwise 
the default printer, or the value of the PRINTER variable in the environment is used). 

FILES 

/etc/printcap printer characteristics file 

/usr/spool/* spooling directories 

/usr/spooI/*/lock lock file used to obtain the pid of the current 

^ daemon and the job number of the currently active job 

SEE ALSO 

Ipr(l), Ipq(l), lpd(8) 

DIAGNOSTICS 

"Permission denied" if the user tries to remove files other than his own. 



BUGS 



Since there are race conditions possible in the update of the lock file, the currently active job 
may be incorrectly identified. 
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NAME 

Is - list contents of directory 

SYNOPSIS 

Is [ — acdfgilqrstulACLFR ] name ... 

DESCRIPTION 

For each directory argument, Is lists the contents of the directory; for each file argument, Is 
repeats its name and any other information requested. By default, the output is sorted alpha- 
betically. When no argument is given, the current directory is Usted. When several arguments 
are given, the arguments are first sorted appropriately, but file arguments are processed before 
directories and their contents. 

There are a large number of options: 

-1 List in long format, giving mode, number of hard links, owner, size in bytes, and time 

of last modification for each file. (See below.) If the file is a special file the size field 
will instead contain the major and minor device numbers. If the file is a symboHc link 
the pathname of the linked-to file is printed preceded by '*->". 

■-"g Include the group ownership of the file in a long output, 

-t Sort by time modified (latest first) instead of by name. 

-a List all entries; in the absence of this option, entries whose names begin with a period 
(,) are not listed. 

— s Give size in kilobytes of each file. 

-d If argument is a directory, Hst only its name; often used with -1 to get the status of a 
directory. 

-L If argument is a symboHc hnk, Ust the file or directory link references rather than the 
link itself. 

— r Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

-u Use time of last access instead of last modification for sorting (with the -t option) 
and/or printing (with the —1 option). 

""-c Use file status change time for sorting or printing. 

-i For each file, print the i-number in the first column of the report. 

-f Force each argument to be interpreted as a directory and list the name found in each 
slot. This option turns off -I^ -t^ -s, and -r^ and turns on -a; the order is the 
order in which entries appear in the directory. 

™F cause directories to be marked with a trailing 7', sockets and fifos with a trailing ( | ), 
symbolic links with a trailing '@', and executable files with a trailing W 

—R recursively list subdirectories encountered. 

-1 force one entry per line output format; this is the default when output is not to a ter- 
minal. 

-C force multi-column output; this is the default when output is to a terminal. 

-q force printing of non-graphic characters in file names as the character '?'; this is the 
default when output is to a terminal. 

The mode printed under the -1 option contains 11 characters which are interpreted as follows: 
the first character is 

d if the entry is a directory; 

b if the entry is a block-type special file; 
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c if the entry is a character-type special file; 

1 if the entry is a symbolic link; 

s if the entry is a socket, or 

p if the entry is a fifo (a.k.a. "named pipe") special files; 

— if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions; the next refers to permissions to others in the same user-group; and the 
last to all others. Within each set the three characters indicate permission respectively to 
read, to write, or to execute the file as a program. For a directory, ^execute' permission is 
interpreted to mean permission to search the directory. The permissions are indicated as fol- 
lows: 

r if the file is readable; 

w if the file is writable; 

X if the file is executable; 

— if the indicated permission is not granted. 

The group-execute permission character is given a? s if the file has the set-group-id bit set; 
likewise the user-execute permission character is given as s if the file has the set-user-id bit set. 

The last character of the mode (normally V or *-') is t if the 1000 bit of the mode is on. See 
chmod{l) for the meaning of this mode. 

When the sizes of the files in a directory are Hsted, a total count of blocks, including indirect 
blocks is printed. 



FILES 



BUGS 



/etc/passwd to get user id's for *ls A\ 
/etc/group to get group id's for *ls -g'. 

Newline and tab are considered printing characters in file names. 

The output device is assumed to be 80 columns wide unless it is a tty with a nonzero window 
size, in which case the window size is used. 

The option setting based on whether the output is a teletype is undesirable as "Is -s" is much 
different than '*ls -s |lpr". On the other hand, not doing this setting would make old shell 
scripts which used Zj* almost certain losers. 

Due to an oversight, many versions of this document incorrectly state that the — c option uses 
the file creation time. Unix does not store file creation times, so this is impossible. 
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NAME \_ 

mkshlib - create a shared library 

SYNOPSIS 

mkshlib — s specfil [— t target] [— h host] [— n] [— q] [—v] 

DESCRIPTION 

The mkshlib command builds both the host and target shared libraries. A shared library is 
similar in function to a normal, non-shared library, except that programs that link with a 
shared library will share the library code during execution. Programs that Hnk with a non- 
shared library will get their own copies of each library routine used. 

The host shared Ubrary is an archive that is used to link-edit user programs with the shared 
library [see ar{4)], A host shared library can be treated exactly like a non-shared library and 
should be included on compiler driver (cc(l), etc.) command lines in the usual way. Further, 
all operations that can be performed on an archive can also be performed on the host shared 
library. 

The target shared library is an executable module that is attached to the user's process during 
execution of a program using the shared library. The target shared library contains the code 
for all the routines in the library and must be fully resolved. The target will be brought into 
memory during execution of a program using the shared library, and subsequent processes that 
use the shared library will share the copy of code already in memory. The text of the target is 
always shared, but each process will get its own copy of the data. 

The user interface to mkshlib consists of command line options and a shared library 
specification file. The shared Ubrary specification file describes the contents of the shared 
library. 

The mkshlib command invokes other tools, such as the archiver, ar(l), the assembler, as(l)y I 

and the link editor, W(l). Tools are invoked through the use of execvp(3), which searches 
directories in the user's PATH. Also, suffixes to mkshlib are parsed in the same manner as 
suffixes to the compiler drivers, and invoked tools are given the suffix, where appropriate. 
For example, mkshlibi.O will invoke Idi.iO. 

The following command line options are recognized by mkshlib: 

-s specfil Specifies the shared library specification file, specfil This file contains the 

information necessary to build a shared Ubrary. Its contents include the 
branch table specifications for the target, the pathname in which the target 
should be installed, the start addresses of text and data for the target, the ini- 
tialization specifications for the host, and the fist of object files to be included 
in the shared library (see details below). 

■-"t target Specifies the name, target, of the target shared library produced on the host 

machine. When target is moved to the target machine, it should be installed 
at the location given in the specification file (see the #target directive below). 
If the -n option is used, a new target shared library will not be generated. 

™h host Specifies the name of the host shared library, host. If this options is not 

given, the host shared library will not be produced. 

-n Do not generate a new target shared library. This option is useful when pro- 

ducing only a new host shared library. The -t option must still be supplied 
since a version of the target shared library is needed to build the host shared 
library. 



-q Quiet warning messages. This option is useful when warning messages are 

expected, but not desired. 

-V Set the verbose option. This option prints the command lines it executes as 
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in the compiler drivers. 

The shared Ubrary specification file contains all the information necessary to build both the 
host and target shared libraries. The contents and format of the specification file are given by 
the following directives: 

#addres§ segname address 

Specifies the start address, address, of the segment segname for the target. 
This directive is used to specify the start addresses of the text and data seg- 
ments. Since the headers part of the text segment of target shared libraries 
they are put on there own page. The real text starts on the next page from 
where the text segment is specified. 

#target pathname 

Specifies the absolute pathname, pathname, of the target shared library on the 
target machine. This pathname is copied to a.out files and is the location 
where the operating system will look for the shared library when executing a 
file that uses it. 

#branch Specifies the start of the branch table specifications. The lines following this 

directive are taken to be branch table specification lines. 

Branch table specification lines have the. following format: 

funcname < white space > position 

where funcname is the name of the symbol given a branch table entry and 
position specifies the position of funcname 's branch table entry. Position may 
be a single integer integer or a range of integers of the form positionl- 
position2. Each position must be greater than or equal to one, the same posi- 
tion cannot be specified more than once, and every position from one to the 
highest given position must be accounted for. 

If a symbol is given more than one branch table entry by associating a range 
of positions with the symbol or by specifying the same symbol on more than 
one branch table specification line, the symbol is defined to have the address 
of the highest associated branch table entry. All other branch table entries 
for the symbol can be thought of as "empty" slots and can be replaced by new 
entries in future versions of the shared library. 

Finally, only functions should be given branch table entries, and those func- 
tions must be external. 

This directive can be specified only once per shared library specification file. 

#objects Specifies the names of the object files constituting the target shared library. 

The lines following this directive are taken to be the Hst of input object files 
in the order they are to be loaded into the target. The Hst simply consists of 
each filename followed by white space. This Hst is also used to determine the 
input object files for the host shared library. 

This directive can be specified only once per shared library specification file. 

#init object Specifies that the object file, object, requires initialization code. The lines fol- 
lowing this directive are taken to be initialization specification Hues. 
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NOTES 



The addresses of tine t^xt mi data segments must meet the boundary requirements of the 
operating ^y^tenj. For UMIPS-V the segments must be on 2 megabyte boundaries. 

Because of jump instructions on MIPS machines, all the text making up the program should 
be in the same 256 megabyte segment so that all the text can be reached by normal jumps. It 
is suggested that shared library text segments be allocated from the top of the first 256 mega- 
byte segment (OxXOOOOOOO) through lower addresses. User program^? text segments would con- 
tinued to be link at the bottom (0x00400000) which is the default. This is suggested so that 
maximum distance be obtained between user's text and shared library text. 

The target shared library data segments are suggested to be allocated from where the normal 
default data segment is loaded (0x10000000) through higher addresses. This will result in the 
user having to load his data segnient after the target shared library he uses with the highest 
data segment address. This suggestion will allow the maximum space for the sbrk(2) arena and 
the stack to grow without interference of target shared library segments. 



( 



MKSHLIB(l) RISC/os Programmer's Reference MKSHLIB(l) 

Initiafeation specification lines have the following format: 

pimport < wlbiite space > import 

Pimport is a pointer to the associated imported symbol, import^ and must be 
d#ned in the current specified object file, aib/ec/. The initialization code gen- 
erated for each such line is of the form: 

pimport !55 &}mport; 

where pimport is the absolute address of import. 

All initiafeations for a particular object file must be given at once and multi- 
ple specifications of the same object file are not allowed. 

#id^nt: string Specifies a string, strings to be included in the .comment section of the target 
shared library/ This directive can be specified only once per shared library 
specification file. This is ignored but allowed for compatibility. 

## Specifies a comment. All information on a line following this directive is 

ignored. 

All directives that may be followed by multi-line specifications are valid until the next directive 
of the end of the file, 

FILES 

TEMPDIRh temporary files 

TEMPDIR is usually /tmp, but can be redefined by setting the environment variable TMPDIR 1^ 

[see tempnamO in tmpnam0S)]. ^ 

SEE ALSO . 

ar(l), as(l), cc(l), ld(l), a,out(5), ar(5) 



( 
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NAME 

nm - name list dump of MIPS object files 

SYNOPSIS 

nm [-abdrfghnopruvxABTY] [ filel ... fileN ] 

DESCRIPTION 

The nm command prints listings formats for the symbol and external sections of the symbol 
table. A file can be an object or an archive. If you do not specify a file, this command 
assumes a, out. 

The -A and -B options specify AT&T System V style output or Berkeley (4.3 
BSD) style output, respectively. The version of UNIX running at your site determines the 
default. NOTEs Some options can change the version-specific defaults. These options change 
the meaning of overloaded flags after -A or -B is specified. 

A normal Berkeley system produces the address or value field followed by a letter showing 
what section the symbol or external is in and the name of the symbol or external. 

These section letters describe the information that nm generates 

N nil storage class, compiler internal usage 

T external text 

t local text 

D . external initialized data 

d local initialized data 

B external zeroed data 

b local zeroed data 

A external absolute 

a local absolute 

U external undefined 

G external small initialized data 

g local small initialized data 

S external small zeroed data 

s local small zeroed data 

R external read only 

r local read only 

C common 

E small common 

V external small undefined 

The standard System V format and the —a specified Berkeley format provide an expanded list- 
ing with these columns: 

Name the symbol or external name 

Value the value field for the symbol or external, usually an address or interesting 
debugging information 

Class the symbol type 

Type the symbol's language declaration 
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Size unused I 

Index the symboFs index field 

Section 

the symboFs storage class 

NOTE: Every effort was made to map the field's functionality into System V nomenclature. 

The nm command accepts these options: 

-a prints debugging information, effectively turning Berkeley into System V for- 

mat 

"b prints the value field in octal 

-d prints the value field in decimal (the System V default) 

-e prints external and statics only 

-f produces full output-nm still accepts this old option^ but ignores it 

-h does not print headers 

-n for System V, sorts external symbols by name (default for Berkeley), and for 

Berkeley, sorts all symbols by value 

-o for System V, prints the value field in octal, and for Berkeley prepends the 

filename to each symbol-good for grepping through nm of libraries 

-p prints symbols as they are found in the file (the System V default) 

-r reverses the sense of a value or name sort 

"U prints only undefined symbols 

-V sorts external symbols by value 

-X prints value field in hexadecimal (Berkeley default) 

-T truncates long names, inserting a '*' as the last printed character 

-V prints version information on stderr 

SEE ALSO 

MIPS System Programmer Guide, MIPS Languages Programmer Guide 



c 
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NAME 

nroff - text formatting 

SYNOPSIS 

nroff [ option ] ... [ file ] ... 

DESCRIPTION 

nroff formats text in the named files for typewriter-like devices. See also troff(l). The full 
capabilities of nroff are described in the nroff ITroff User's Manual, 

If no file argument is present, the standard input is read. An argument consisting of a single 
minus (— ) is taken to be a file name corresponding to the standard input. 

The options, which may appear in any order so long as they appear before the files, are: 

—oto Print only pages whose page numbers appear in the comtna-separated list of numbers 
and ranges. A range N'^M means pages N through M; an initial -A^ means from 
the beginning to page N\ and a final N- means from N to the end. 

— niV Number first generated page N. 

— sA^ Stop every N pages, nroff will halt prior to every N pages (default AT-l) to allow 
paper loading or changing, and will resume upon receipt of a newline, 

^mname Prepend the macro file /usr/lib/tmac/tmac/ia/ne to the input files . 

— raN Set register a (one-character) to iV. 

-i Read standard input after the input files are exhausted. 

— q Invoke the simultaneous input-output mode of the rd request. 

-^Tname Prepare output for specified terminal. Known names are 37 for the (default) Tele- 
type Corporation Model 37 terminal, tn300 for the GE TermiNet 300 (or any termi- 
nal without half-line capability), 300S for the DASI-300S, 300 for the DASI-300, and 
450 for the DASI-450 (Diablo Hyterm). 

— e Produce equally-spaced words in adjusted lines, using full terminal resolution. 

--^h Use output tabs during horizontal spacing to speed output and reduce output charac- 

ter count. Tab settings are assumed to be every 8 nominal character widths. 

FILES 

/tmp/ta* temporary file 

/usr/lib/tmac/tmac* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 

SEE ALSO 

J. F. Ossanna, nroff/Troff user's manual 

B. W. Kemighan, A TROFF Tutorial 

troff(l), eqn(l), tbl(l), ms(7), me(7), man(7), col(l) 
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NAME 

od - octal;, decimal, hex, ascii dump 

SYNOPSIS 

od [ -format ] [ file ] [ [+]offset[.][b] [label] ] 

DESCRjDPTION 

od displays /i/e, or it's standard input, in one or more dump formats as selected by the first 
argument. If the first argument is missing, '^o is the default. Dumping continues until end- 
of-file. 

The meanings of the format argument characters are; 

a Interpret bytes as characters and display them with their ACSn names. If the p charac- 
ter is ^ven also, then bytes with even parity are underlined. The P character causes 
'bytes with odd parity to be underlined. Otherwise the parity bit is ignored. 

b Interpret bytes as unsigned octal. 

c Interpret bytes as ASCII characters. Certain non-graphic characters appear as C 
escapes: null=^\0, backspace=^\b, formfeed^Xf, newline=\n, retum=-\r, tab=*\t; others 
appear as 3-digit octal numbers. Bytes with the parity bit set are displayed in octal. 

d Interpret (short) words as unsigned decimal. 

f Interpret long words as floating point. 

h Interpret (short) words as unsigned hexadecimal 

i Interpret (short) words as signed decimal. 

i Interpret long words as signed decimal. 

o Interpret (short) words as unsigned octal. 

s[n] Look for strings of ascii graphic characters, terminated with a null byte. N specifies the 
minimum length string to be recognized. By default, the minimum length is 3 characters. 

V Show all data. By default, display lines that are identical to the last line shown are not 
output, but are indicated with an^**" in column 1. 

w[n] Specifies the number of input bytes to be interpreted and displayed on each output line. 
If w is not specified^ 16 bytes are read for each display line. If n is not specified, it 
defaults to 32. 

X Interpret (short) words as hexadecimal. 

An upper case format character implies the long or double precision form of the object. 

The offset argument specifies the byte offset into the file where dumping is to commence. By 
default this argument is interpreted in octal. A different radix can be specified; If **." is 
appended to the argument, then offset is interpreted in decimal. If offset h^gms with ''%'' or 
"Ox'', it is interpreted in hexadecimal. If "b'^ ('*B") is appended, the offset is interpreted as a 
block count, where a block is 512 (1024) bytes. If Xh^file argument is omitted, ^n off set argu- 
ment must be preceded by '*4'". 

The radix of the displayed address will be the same as the radix of the offset, if specified; oth- 
erwise it will be octal. 

Label will be interpreted as a pseudo-address for the first byte displayed. It will be shown in 
"()'' following the file offset. It is intended to be used with core images to indicate the real 
memory address. The syntax for /aM is identical to that for oj^T^er. 
SEE ALSO 

adb(l) 
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BUGS 

A file name argument can't start with '*+''. A hexadecimal offset can't be a block count. 
Only one file name argument can be given. 

It is an historical botch to require specification of object, radix, and sign representation in a 
single character argument. 
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NAME 

odump - dumps selected parts of an object jfile 

SYNOPSIS 

odump [ -a -c -f -g -h 4-1 -o -r -s -t -F -P -R -z -L] filel .,. jfileN 

DESCRIPTION 

The odump command dumps selected parts of each object jf?/e. 

This command works for object files and archives of object files. It accepts one or more of 
these options: 

—a Dumps the archive header for each member of the specified archive file. 

—f Dumps each file header. 

•™g Dumps the global symbols from the symbol table of a MIPS archive, 

■^o Dumps each optional header. 

— h Dumps section headers. 

--i Dumps the symboUc information header. 

■^s Dumps section contents. 

— r Dumps relocation information. 

■=-1 Dumps line number information. 

— t Dumps symbol table entries. 

—zname Dumps line number entries for the specified function name. 

— c Dumps the string table. 

— L Interpret and print the contents of the Mb sections. 

■--F Dumps the file descriptor table. 

—P Dumps the procedure descriptor table. 

— R Dumps the relative file index table. 

The odump command accepts these modifiers with the options: 

--d number Dumps the section number or a range of sections starting at number and 
ending either at the last section number or the number you specify with 
+d. 

-^d number Dumps sections in the range beginning with the first section or beginning 
with the section you specify with •"•d. 

-nname Dumps information only about the specified name. This modifier works 
with -h, ---s, -r, —1, and — t. 

■^p Does not print headers 

'-'t index Dumps only the indexed symbol table entry. You can also specify a 
range of symbol table entries by using the modifier --t with the +t 
option. 

-^t index Dumps the symbol table entries in the specified range. The range begins 
at the first symbol table entry or at the entry specified by "-t* The range 
ends with the specified indexed entry. 

-u Underlines the name of the file for emphasis. 

-V Dumps information symbolically rather than numerically (for example, | 

Static rather than 0X02 ). You can use -^v with all the options except ^- 
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— s. 

'^zname,number 

Dumps the specified line number entry or a range of line numbers. The 
range starts at the number for the named function. 

'¥z number Dumps line numbers for a specified range. The range starts at either the 
name or number specified by -z The range ends with the number 
specified by +z. 

Optionally, an option and its modifier can be separated by using blanks. The name 
can be separated from the number that modifies -z by replacing the comma with a 
blank. 

The odump command tries to format information in a helpful way, printing informa- 
tion in character, hexadecimal, octal, or decimal, as appropriate. 

SEE ALSO 

a.out(4), ar(4). 
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NAME 

pagesize - print system page size 

SYNOPSIS 

pagesize 

DESCRIPTION 

pagesize prints the size of a page of memory in bytes, as returned hy getpagesize{2). This pro- 
gram is useful in constructing portable shell scripts. 

SEE ALSO 

getpagesixe(2) 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



PC(1) RISC/os Programmer's Reference PC(1) 



( 



NAME 

pc - MIPS Pascal compiler 

SYNOPSIS 

pc [ option ] ... j&le ... 

DESCRIPTION 

PCy the MIPS wc6><ie Pascal compiler, produces files in the following formats: MIPS object 
code in MIPS extended coff format (the normal result), binary or symbolic ucode, ucode 
object files and binary or symbolic assembly language. Pc accepts several types of arguments: 

Arguments whose names end with '.p' are assumed to be Pascal source programs. They are 
compiled, and each object program is left in the file whose name consists of the last com- 
ponent of the source with *,o' substituted for ^p'. The '.o' file is only deleted when a single 
source program is compiled and loaded all at once. 

Arguments whose names end with ^s' are assumed to be symbolic assembly language source 
programs. They are assembled, producing a ^o' file. Arguments whose names end with *.i' 
are assumed to be Pascal source after being processed by the C preprocessor. They are com- 
piled without being processed by the C preprocessor. 

If the highest level of optimization is specified (with the —03 flag) or only ucode object files 
are to be produced (with the -^j flag) each Pascal source file is compiled into a ucode object 
file, The ucode object file is left in a file whose name consists of the last, component of the 
source with ^u' substituted for \p'. 

The suffixes described below primarily aid compiler development and are not generally used. 
Arguments whose names end with \W , \0\ '.S', and ',M' are assumed to be binary ucode ^ 
produced by the front end, optimizer, ucode object file splitter and ucode merger respectively. ^ 

Arguments whose names end with MJ' are assumed to be symbolic ucode. Arguments whose f 

names end with *.G' are assumed to be binary assembly language, which is produced by the ^ 

code generator and the symbolic to binary assembler. 

Files that are assumed to be binary ucode ^ symbolic ucode, or binary assembly language by 
the suffe conventions are also assumed to h^ve their corresponding symbol table in a file with 
a ^^ suffix. 

Pc always defines the C preprocessor macros mips, host_mips and unix to the C macro 
preprocessor. Pc defines the C preprocessor macro LANGUAGE_PASCAL when a ^p' file is 
being compiled. Pc will define the C preprocessor macro LANGUAGE^ASSEMBLY when a 
^s' file is being compiled. It also defines SYSTYPE_SYSY by default but this changes if the 
"-systype name option is specified (see the description below). 

The following options are interpreted by pc and have the same meaning in cc(l). See ld{l) 
for load-time options. 

— c Suppress the loading phase of the compilation and force an object file to be pro- 

duced even if only one program is compiled. 

— gO Have the compiler produce no symbol table information for symbolic debugging. 
This is the default. 

— gl Have the compiler produce additional symbol table information for accurate but lim- 
ited symbolic debugging of partially optimized code. 

-g or -g2. 

Have the compiler produce additional symbol table information for full symbolic 
debugging and not do optimizations that limit full symbolic debugging. 

— g3 Have the compiler produce additional symbol table information for full symbolic 
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debugging for fully optimized code. This option makes the debugger inaccurate. 

— w Suppress warning messages. 

~pO Do not permit any profiling. This is the default. If loading happens, the standard 
runtime startup routine (crtl.o) is used, no profiling library is searched. 

—pi or -p 

Set up for profiling by periodically sampling the value of the program counter. This 
option only effects the loading. When loading happens, this option replaces the stan- 
dard runtime startup routine with the profiling runtime startup routine (mcrtl.o) and 
searches the level 1 profiling library (libprofl.a). When profiling happens, the startup 
routine calls monstartup{3) and produces a file mon.out that contains execution- 
profiling data for use with the postprocessor prof (I), 

—GO Turn off all optimizations. 

— Ol Turn on all optimizations that can be done quickly. This is the default. 

-O or -02 

Invoke the global ucode optimizer. 

-03 Do all optimizations, including global register allocation. This option must precede 
all source file arguments. With this option, a ucode object file is created for each 
Pascal source file and left in a '.u' file. The newly created ucode object files, the 
ucode object files specified on the command line and the runtime startup routine and 
all the runtime libraries are ucode linked. Optimization is done on the resulting 
ucode linked file and then it is linked as normal producing an "a.ouf' file. No result- 
ing \o^ file is left from the ucode linked result as in previous releases. In fact ~c can 
no longer be specified with -03. 

—feedback /?/e 

Used with the -cord option to specify file to be used as a feedback file. This file is 
produced by prof{l) with its -feedback option from an execution of the program 
produced hy pixie (1), 

-cord Run the procedure-rearranger, cord{l), on the resulting file after linking. The rear- 
rangement is done to reduce the cache conflicts of the program's text. The output of 
cord{l) is left in the file specified by the -o output option or 'a.out' by default. At 
least one — feedback ^/e must be specified. 

— j Compile the specified source programs, and leave the ucode object file output in 

corresponding files suffixed with *.u'. 

— ko output 

Name the output file created by the ucode loader as output. This file is not removed. 
If this file is compiled, the object file is left in a file whose name consists of output 
with the suffix changed to a '.o'. If output has no suffix, a '.o' suffix is appended to 
output,' 

— k Pass options that start with a -k to the ucode loader. This option is used to specify 

ucode libraries (with — kU ) and other ucode loader options. 

— S Compile the specified source programs and leave the symbolic assembly language out- 

put in corresponding files suffixed with '.s'. 

— P Ruti only the C macro preprocessor and put the result for each source file (by suffix 

convention, i.e. '.p' and '.s') in a corresponding M' file. The M' file has no '#' lines 
in it. This sets the — cpp option. 

— E Run only the C macro preprocessor on the files (regardless of any suffix or not), and 

send the result to the standard output. This sets the -cpp option. 



Page 2 February 13, 1989 MIPS Computer Systems, Inc. 



PC ( 1 ) RISC/os Programmer's Reference PC ( 1 ) 



— o output 

Name the final output file output. If this option is used, the file 'a. out' is undis- 
turbed. 

'-Dname—def 
•-Dname 

Define the name to the C macro preprocessor, as if by *#define\ If no definition is 

given, the name is defined as '1". 

—JJname 

Remove any initial definition of name . 

--Idir '#include' files whose names do not begin with V are always sought first in the direc- 
tory of the file argument, then in directories specified in -^I options j and finally in the 
standard directory (/usr/include), 

—I This option will cause *#include' files never to be searched for in the standard direc- 

tory (/usr/include), 

---G num 

Specify the maximum size, in bytes, of a data item that is to be accessed from the 
global pointer. Num is assumed to be a decimal number. Knum is zero, no data is 
accessed from the global pointer. The default value for num is 8 bytes. 

—V Print the passes as. they execute with their arguments and their input and output files. 

—V Print the version of the driver and the versions of all passes. This is done with the 
what{l) command. 

™std Have the compiler produce warnings for things that are not standard in the language. 
The C macro preprocessor is not run on *.p' files if this option is present. 

— cpp Run the C macro preprocessor on Pascal and assembly source files before compiling. 
This is the default for pc(l). 

--nocpp 

Do not run the C macro preprocessor on Pascal and assembly source files before 
compiling. 

— Olimit num 

Specify the maximum size, in basic blocks, of a routine that will be optimized by the 
global optimizer. If a routine has more than this number of basic blocks it will not 
be optimized and a message will be printed. An option specifying that the global 
optimizer is to be run ("-0, — 02, or -03) must also be specified. Num is assumed 
to be a decimal number. The default value for num is 500 basic blocks. 

Either object file target byte ordering can be produced by pc. The default target byte ordering 
matches the machine where the compiler is running. The options -EB and -EL specify the 
target byte ordering (big-endian and little-endian, respectively). The compiler also defines a C 
preprocessor macro for the target byte ordering. These C preprocessor macros are MIFSEB 
and MIPSEL for big-endian and little-endian byte ordering respectively. 

If the specified target byte ordering does not match the machine where the compiler i$ run- 
ning, then the runtime startups and libraries come from /usr/libeb for big-endian runtimes on 
a little-endian machine and from /usr/libel for little-endian runtimes on a big-endian machine. 

— EB Produce object files targeted for big-endian byte ordering. The C preprocessor macro 
MIPSEB is defined by the compiler. 

—EL Produce object files targeted for little-endian byte ordering. The C preprocessor 
macro MIPSEL is defined by the compiler. 
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The following option is specific for pc : 

~C Generate code for runtime range checking. The default suppresses range checking. 

The option described below is primarily used to provide UNIX compilation environments 
other than the native compilation environment. 

— systype name 

Use the named compilation environment name. See compilation (7) for the compila- 
tion environments that are supported and their names. This has the effect of changing 
the standard directory for *#include' files, the runtime libraries and where runtime 
libraries are searched for. The new items are located in their usual paths but with 
/name prepended to their paths. Also a preprocessor macro of the form 
SYSTYPE_/sMM£' (with name capitalized) is defined in place of the default 
SYSTYPE_SYSV- 

The options described below primarily aid compiler development and are not generally used: 

—He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ fjusmoca ]. It selects the compiler pass in the 
same way as the — t option. If this option is used, the symbol table file produced and 
used by the passes, is the last component of the source file with the suffix changed to 
'.T' and is not removed. 

-K Build and use intermediate file names with the last component of the source file's 
name replacing its suffix with the conventional suffix for the type of file (for example 
*.B' file for binary ucode, produced by the front end). These intermediate files are 
never removed even when a pass encounters a fatal error. When ucode linking is per- 
formed and the — K option is specified the base name of the files created after the 
ucode link is *u.out' by default. If — ko output is specified, the base name of the 
object file is output without the suffix if it exists or suffixes are appended to output if it 
has no suffix. 

-# Converts binary ucode files ('.B') or optimized binary ucode files ('.O') to symbolic 
ucode (a '.U' file) using btou{l), 

-Wc[c..,],argl[,arg2.,J 

Pass the argument[s] argi to the compiler pass[es] c[c..J, The c's are one of [ pfjusmo- 
cablyz ]. The c's selects the compiler pass in the same way as the — t option. 

The options — t[hpfjusmocablyzrFMnt], '■^hpath, and —Bstring select a name to use for a par- 
ticular pass, startup routine, or standard library. These arguments are processed from left to 
right so their order is significant. When the -B option is encountered, the selection of names 
takes place using the last — h and — t options. Therefore, the — B option is always required 
when using -h or -t. Sets of these options can be used to select any combination of names. 

The — EB or -EL options, the -p[01] options and the -systype option must precede all -B 
options because they can affect the location of runtimes and what runtimes are used. 

— t[hpfjusmocablyzrPMnt] 

Select the names. The names selected are those designated by the characters follow- 
ing the — t option according to the following table: 
Name Character 

include h (see note below) 



cpp 


P 


upas 


f 


ujoin 


J 


uld 


u 


usplit 


s 
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umerge 


m 


uopt 





ugen 


c 


asO 


a 


asl 


b 


Id 


1 


ftoc 


y 


cord 


z 


[m]crt[ln].o 


r 


libexc.^ 


E 


libp.a 


P 


libm.a 


M 


libprofl,a 


n 


btou, utob 


t 



FILES 



file.p input file 

jBle-o object file 

a.out loaded output 

/tmp/ctm? temporary 
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If the character *h' is in the —t argument then a directory is added to the list of direc- 
tories to be used in searching for '#include' files. This directory name has the form 
COMfJTAKQETJkOOT/n^T/mcludestring . This directory is to contain the include files 
for the string release of the compiler. The standard directory is still searched. 

Use path rather than the directory where the name is normally found. 

-^Bstring 

Append string to all names specified by the -^t option. If no -^t option has been pro- 
cessed before the '-•B, the -^t option is assumed to be **hpfjusmocablyzrPMnt". This . 
list designates all names. If no -^t argument has been processed before the -B then a ^ 

^l&string is passed to the loader to use with its -^Ir arguments. I 

Invoking the compiler with a name of the form pcstring has the same effect as using a 
'--Bstring option on the command line. 

If the environment variable COMP^HOST„R0OT is set, the value is used as the root directory 
for all pass names rather than the default /. If the environment variable 
COMP^TARGET^ROOT is set, the value is used as the root directory for all include and library 
names rather than the default /. This affects the standard directory for '#include' files, 
/usr/include, aud the standard library, /usr/lib/libc.a. If this is set, the first directory that is 
searched for libraries, using the — br option, is COMP^TARGET^ROOT/usr/h'b/cmplrs/cc. The 
standard directories for libraries are then searched, see W(l). 

If the environment variable TMFDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ . 

If the environment variable RLSJD^OBJECT is set, the value is used as the name of an object 
to link in if a link takes place. This is used to add release identification information to 
objects. It is always the last object specified to the loader. See rlsjd(l) for the tools to 
create this information. 

Other arguments are assumed to be either loader options or Pascal-compaXihle object files, 
typically produced by an earlier pc run, or perhaps libraries of Pa^caZ-compatible routines. 
These files, together with the results of any compilations specified, are loaded in the order 
given, producing ^n e?cecutable program with the default name a.out. 
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/usr/lib/cpp 

/usr/lib/upas 

/usr/lib/ujoin 

/usr/bin/uld 

/usr/lib/usplit 

/usr/lib/umerge 

/usr/lib/uopt 

/usr/lib/ugen 

/usr/lib/asO 

/usr/lib/asl 

/usr/lib/crtl.o 

/usr/lib/crtn.o 

/usr/lib/mcrtl.o 

/usr/lib/libc.a 

/usr/lib/libprofl.a 

/usr/lib/libexc.a 

/usr/lib/libp.a 

/usr/lib/libm.a 

/usr/include 

/usr/bin/ld 

/usr/lib/ftoc 

/usr/lib/cord 

/usr/bin/btou 

/usr/bin/utob 

mon.out 



C macro preprocessor 

Pascal front end 

binary ucode and symbol table joiner 

ucode loader 

binary ucode and symbol table splitter 

procedure intergrator 

optional global ucode optimizer 

code generator 

symbolic to binary assembly language translator 

binary assembly language assembler and reorganizer 

runtime startup 

runtime startup 

startup for profiling 

standard library, see /n^(9 (3) 

level 1 profiling library 

Exception handling library 

Pascal library 

Math library 

standard directory for '#include' files 

MIPS loader 

interface between prof{l) and cord(l) 

procedure-rearranger 

binary to symbolic ucode translator 

symbolic to binary ucode translator 

file produced for analysis by prof(l) 

Runtime startups and libraries for the opposite byte sex of machine the compiler is running on 
have the same names but are located in different directories. For big-endian runtimes on a 
little-endian machine the directory is /usr/libeb and for little-endian runtimes on a big-endian 
machine the directory is /usr/libel. 

SEE ALSO 

Languages Programmer's Guide 

cc(l), as(l), monstartup(3), prof(l), ld(l), dbx(l), what(l), cord(l), pixie(l), fto 

DIAGNOSTICS 

The diagnostics produced by pc are intended to be self-explanatory. Occasional messages may 
be produced by the assembler or loader. 



NOTES 



The standard library, /usr/lib/libc.a, is loaded by using the -Ic loader option and not a full 
path name. The wrong one could be loaded if there are files with the name lihcastring in the 
directories specified with the — L loader option or in the default directories searched by the 
loader. 

The handling of include directories and libc.a is confusing. 
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NAME 

pixie - add profiling code to a program 

SYNOPSIS 

pixie in_prog__name [ options ] 

DESCRIPTION 

Pixie reads an executable program, partitions it into basic blocks, and writes an equivalent 
program containing additional code that counts the execution of each basic block. (A basic 
block is a" region of the program that can be entered only at the beginning and exited only at 
the end). Pixie also generates a file containing the address of each of the basic blocks. 

When you run the pixie-generated program, it will (provided it terminates normally or via a 
call to exit{2)) generate a file containing the basic block counts. The name of the file is that of 
the original program with any leading directory names removed and ".Counts" appended. 
prof{l) and pixstats{l) can analyze these files and produce a Usting of profiling data. 

— [no] quiet 

[Permits] or suppresses messages summarizing the binary-to-binary translation process. 
Default: — noquiet. 

-[no]branchcounts 

-brarichcounts inserts extra counters to track whether each branch instruction is taken 
or not taken. When this option is used, pixstats will automatically print more statis- 
tics. Default: -nobranchcounts. 

'-[no]idtrace 

[Disable] or enable tracing of instruction and data memory references, —idtrace is 
equivalent to using both ^^itrace and -^dtrace together. Default: -^noidtrace 

-^[no]itrace 

[Disable] or enable tracing of instruction memory references. Default: ---noitrace 

-^[no]dtrace 

[Disable] or enable tracing of data memory references. For the moment, -^dtrace 
requires -"itrace. Default: — nodtrace 

«-idtrace__file number 

Specify a UNIX file descriptor number for the trace output file. Default: 19. 

"-bbaddrs name 

Specify a name for the file of basic block addresses. Default is to remove any leading 
directory names from the in_progjQame and append ".Addrs". 

-bbcoiints name 

Specifies the full filename of the basic block counts file. Default: objfile.Counts. 

-mipsl Use the MIPSl instruction set (R2000, R3000) for output executable. This is the 
default. 

-mips2 Use the MIPS2 instruction set (a superset of MIPSl) for output executable. 

SEE ALSO 

prof{l), pixstats (1). 

The MIPS Languages Programmer's Guide, 



BUGS 



( 



( 



The handler function address to the signal system calls is not translated, and so programs that 
receive signals will not work pixified. 

Programs that call vforkQ will not work pixified because the child process will modify the g- 

parent state required for pixie operation. JJsefork() instead. f 
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Pixified code is substantially larger than the original code. Conditional branches that used to 
fit in the 16-bit branch displacement field may no longer fit, generating a pixie error. 
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NAME 

pixstats r- analyi^e program exQCUtioti 

SYNOF^JB 

pijcstatis program [ options ] 

DESCRIPTION 

Fimats analy^je?; a program^s e^^ecution characteristics. To use pixstats, first use Pixie{i) to 
translate and instrument the e^^ecutable object module for the program. Next, execute the 
translation on an appropriate input. Thi^ produces a .Counts file. Finally, use pixstats to gen- 
erate a detailed report on opcode frequencies, interlocks? a mini-profile, and more. 

Assume a ns cycle time when converting cycle counts to seconds. 

Use r2010 floating point chip operation times and overlap rules. This is the default. 

-r?360 

Use r2360 floating point board operation times and overlap rules, 

Pisassemble and show the analyzed object code. 

SEE ALSO 

pm^(X), prof (1), The MIPS Lan^uage^ Programm 

BIPGS 

Pixmts models e?{;ecution assuming a perfect memory system. Cache misses etc. will increase 
execution above the ptor<^r^ predictions. 
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NAME 

pll - MIPS PL/I compiler 

SYNOPSIS 

pll [ option ] ... file ... 

DESCRIPTION 

Pll, the MIPS PL/I compiler, produces either relocatable object ('.o') files or linked execut- 
able ('a. out') files. It can also produce binary or symboHc intermediate code called ucode, 
ucode object files, and binary or symbolic assembly language. Pll accepts several types of 
arguments: 

Arguments whose names end with '.pll' or '.pH' are assumed to be PL/I source programs. 
They are compiled, and each object program is left in the file whose name consists of the last 
component of the source with '.o' substituted for '.pll' or '.ph'. The '.o' file is only deleted 
when a single source program is compiled and loaded all at once. 

The suffixes described below primarily aid compiler development and are not generally used. 
Arguments whose names end with '.F', '.O', '.S', and '.M' are assumed to be binary ucode, 
produced by the front end, optimizer, ucode object file splitter and ucode merger respectively. 
Arguments whose names end with '.U' are assumed to be symbolic ucode. Arguments whose 
names end with '.G' are assumed to be binary assembly language, which is produced by the 
code generator and the symbolic to binary assembler. 

Files that are assumed to be binary ucode ^ symbolic ucode i or binary assembly language by 
the suffix conventions are also assumed to have their corresponding symbol table in a file with 
a '.T' suffix. 
The following options are interpreted hy pll {!), See ld{l) for load-time options. 

— c Suppress the loading phase of the compilation and force an object file to be pro- 

duced even if only one program is compiled. 

— gO Have the compiler produce no symbol table information for symbolic debugging. 
This is the default. 

— gl Have the compiler produce additional symbol table information for accurate but lim- 
ited symboUc debugging of partially optimized code. 

-g or -g2 

Have the compiler produce additional symbol table information for full symbolic 
debugging and not do optimizations that limit full symboUc debugging. 

— g3 Have the compiler produce additional symbol table information for full symbolic 
debugging for fully optimized code. This option makes the debugger inaccurate. 

— w Suppress warning messages. 

-pO Do not permit any profiling. This is the default. If loading happens, the standard 
runtime startup routine (crtO.o) is used, no profiling library is searched. 

—pi or — p 

Set up for profiling by periodically sampling the value of the program counter. This 
option only affects the loading. When loading happens, this option replaces the stan- 
dard runtime startup routine with the profiling runtime startup routine (mcrtO-o) and 
searches the level 1 profiling library (libprofl.a). When profiling happens, the startup 
routine calls monstartup(3) and produces a file mon.out that contains execution- 
profiling data for use with the postprocessor mprof(l). 

—GO Turn off all optimizations. 

-Ol Turn on all optimizations that can be done quickly. This is the default. 
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-O or -02 

Invoke the global ucode optimizer. 

— S Compile the specified source programs and leave the symbolic assembly language out- 

put in corresponding files suffixed with \s\ 

— P Run only the C macro preprocessor and put the result for each source file (by suffix 
convention, i.e, \c^ and *.s') in a corresponding M' file. The *.i' file has no *#' lines 
in it. 

-^o output 

Name the final output file output. If this option is used, the file *a.out' is undis- 
turbed, 

'^Gnum 

Specify the maximum size, in bytes, of a data item that is to be accessed from the 
global pointer. Num is assumed to be a decimal number. If num is zero, no data is 
accessed from the global pointer. The default value for /zwm is 512 bytes. 

-V Print the passes as they execute with their arguments and their input and output files. 

Also prints resource usage in the C-shell time format. 

-V Print the version of the driver and the versions of all passes. This is done with the 
what{V) command. 

-5 Use the BRL System V emulation include files and libraries instead of the default 

include files and libraries. The include files are in /usr/5include and the runtime 
libraries are in /usr/51ib, as modified by other options if appropriate. 

The following options are specific to pll : 

•-ipath directory 

Search for %include files in the specified directory rather than the current directory. 
You may specify a list of directories either by using separate -ipath options, or by 
placing multiple directory names (separated by ':' characters) after a single -ipath 
option. The directories will be searched in order. 

•™defext 

Pay attention to init clauses associated with external declarations (the default is to 
ignore them). 

The options described below primarily aid compiler development and are not generally used: 

-He Halt compiling after the pass specified by the character c, producing an intermediate 
file for the next pass. The c can be [ fkjusmoca ]. It selects the compiler pass in the 
same way as the — t option. If this option is used, the symbol table file produced and 
used by the passes, is the last component of the source file with the suffix changed to 
*. TV and is not removed. 

— K Build and use intermediate file names with the last component of the source file's 
name replacing its suffix with the conventional suffix for the type of file (for example 
*.F' file for binary wcode, produced by the front end). These intermediate files are 
never removed, even when a pass encounters a fatal error. 

'-'Wc,argl[,arg2,,J 

Pass the argument[s] argi to the compiler pass c. The c is one of [ pfkjusmocabl ]. 
The c selects the compiler pass in the same way as the — t option. 

The options — t[hpfjusmocablmt], --hpath, and '--Bstring select a name to use for a particular 
pass, startup routine, or standard library. These arguments are processed from left to right so 
their order is significant. When the —B option is encountered, the selection of names takes 
place using the last -h and — t options. Therefore, the —B option is always required when 
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using -h or ~t. Sets of these options can be used to select any combination of names. 

The -EB or -EL options, any of the -p[0123] options and any of the -g[123] options must 
precede all -B options because they can affect the location of runtimes and what runtimes are 
used. 

-^t[hpfjusmocablmt] 

Select the names. The names selected are those designated by the characters follow- 
ing the -t option according to the following table: 
Name Character 



include 


h (see note below) 


cpp 

pUfe 

ulpi 


P 
f 

k 


ujoin 
uld 


J 
u 


usplit 


s 


umerge 
uopt 


m 
o 


ugen 


c 


asO 


a 


asl 


b 


Id 


1 


[m]crt[01n].o 
libpU.a 
libprofl.a 
btou, utob 


r 
1 
n 
t 



If the character 'h' is in the -t argument then a directory is added to the list of direc- 
tories to be used in searching for *#include' files. This directory name has the form 
ROOTDIR/includestring . This directory is to contain the include files for the string 
release of the compiler. The standard directory is still searched. 

^hpath 

Use path rather than the directory where the name is normally found. 

•^Bstring 

Append string to all names specified by the -t option. If no -^t option has been pro- 
cessed before the -B, the -t option is assumed to be "hpfjusmocablrint". This list 
designates all names. If no — t argument has been processed before the — B then a 
-^Bstring is passed to the loader to use with it's -k arguments. 

Invoking the compiler with a name of the form pllstring has the same effect as using a 
'-Bstring option on the command line. 

If the environment variable COMP_HOST_ROOT is set, the value is used as the root directory 
for all pass names rather than the default /. If the environment variable 
COMP_TARGET_ROOT is set, the value is used as the root directory for library names rather 
than the default /. This affects the standard library, /usr/lib/libc.a. If this is set, the first 
directory that is searched for libraries, using the -k option, is 
CQMP_TARGET_ROOT/usr/h'b/cmplrs/cc. The standard directories for libraries are then 
searched, see ld(l), 

K the environment variable TMPDIR is set, the value is used as the directory to place any tem- 
porary files rather than the default /tmp/ , 
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FILES 



Other ?irgumentis are assumed to be either loader options or /? /incompatible object files, typi- 
cally produced by an eariier p/i run, or perhaps libraries of /?/i -compatible routines. These 
hies, together with the resuhs of any compilations specified, are loaded in the order given, 
producing an executable program with the default name a^out. 



file.pU 

file.o 

^.out 

/tmp/ctm? 

/usr/lib/cpp 

/usr/lib/plXfe 

/usr/Hb/ulpi 

/usr/lib/ujoin 

/usr/bin/uld 

/usr/lib/uspht 

/usr/lib/umerge 

/usr/lib/uopt 

/usr/lib/ugen 

/usr/lib/asO 

/usr/lib/asl 

/usr/lib/crtO«o 

/u$r/Ub/mcrt0.o 

/usr/lib/libc,a 

/usr/lib/libprofX,a 

/usr/include 

/usr/bin/ld 

/usr/bin/btou 

/usr/bin/utob 

mon,out 



input file 

object file 

loaded output 

temporary 

C macro preprocessor 

pll front end 

front-end to ucode translator 

binary ucode and symbol table joiner 

ucode loader 

binary ucode and symbol table splitter 

procedure intergrator 

optional global ucode optimizer 

code generator 

symbolic to binary assembly language translator 

binary assembly language assembler and reorganizer 

runtime startup 

startup for profiling 

standard library, see intra (3) 

level 1 profiling library 

standard directory for *#include' files 

MIPS loader 

binary to symbolic ucode translator 

symboUc to binary ucpde translator 



( 



file produced for analysis by pro/(l) 

Runtime startupis and libraries for the opposite byte sex of machine the compiler is running on 
have the !?ame names but are located in different directories. For big-endian runtimes on a 
little-endian machine the directory is /usr/libeb and for little-endian runtimes on a big-endian 
machine the directory is /u§r/libel. 

Sm ALSO 

coff(5), mon§tartup(3), prQf(l), ld(l), dbx(X), what(l) 

DIAGNOSTICS 

The diagnostics produced by pU are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. 

NOTES 

The standard library, /usr/lib/libc,a, is loaded by using the -Ic loader Option and not a full 
path name. The wrong one could be loaded if there are files with the name lihc, ^string in the 
directories specified with the -^h loader option or in the default directories searched by the 



( 



Page 4 



February 13, 1989 



MIPS Computer Systems, Inc. 



PLl ( 1 ) RISC/os Programmer's Reference PLl ( 1 ) 



loader. 

The handling of include directories and libc.a is confusing. 
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NAME 

pr - print file 

SYNOPSIS 

pr [ option ] . . , [ file ] . . . 

DESCRIPTION 

pr produces a printed listing of one or more files. The output is separated into pages headed 
by the date that the file was last modified (or the current date if standard input is used), the 
name of the file or a specified header, and the page number. If there are no file arguments, pr 
prints its standard input. 

Options apply to all following files but may be reset between files: 

^n produce n -column output. 

+n Begin printing with page n, 

•™h Take the next argument as a page header. 

—wn For purposes of multi-column output, take the width of the page to be n characters 
instead of the default 72. 

— f Use formfeeds instead of newlines to separate pages. A formfeed is assumed to use 
up two blank lines at the top of a page. (Thus this option does not affect the effective 
page length.) 

'^In Take the length of the page to be n lines instead of the default 66, 

— t Do not print the 5-Hne header or the 54ine trailer normally supplied for each page. 

— sc Separate columns by the single character c instead of by the appropriate amount of ^ 

white space, A missing c is taken to be a tab, I 

— m print ^JH files simultaneously, each in one column, 

—b Break up lines wider than the page width. This is useful for printing with printers and 
window systems that do not wrap long lines. 

Inter-terminal messages via write{l) are forbidden during apr. 

FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

cat(l) 

DIAGNOSTICS 

There are no diagnostics when pr is printing on a terminal. 



( 
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NAME 

prof - analyze profile data 

SYNOPSIS 

prof [ options ] [ prog_name [ pcsampling„data_file ... ] ] 

prof -note ''comment string'' -pixie [ options ] [ prog_name [ bbaddrsjile [ bbcounts_file .,. ] ] 

] 

DESCRIPTION 

Prof analyzes one or more data files generated by the MIPS compiler's execution-profiling sys- 
tem and produces a listing. Prof can also combine those data files or produce a feedback file 
that lets the optimizer take into account the program's runtime behavior during a subsequent 
compilation. Profiling is a three-step process: first compile the program, then execute it, and 
finally run prof to analyze the data. 

The compiler system provides two kinds of profiling: 

1. pc-sampling interrupts the program periodically, recording the value of the program 
counter. 

2. basic-block counting divides the program into blocks delimited by labels, jump instructions, 
and branch instructions. It counts the number of times each block executes. This provides 
more detailed (line by fine) information than pc-sampling. 

Using pc-isampling 

To use pc-sampling, compile your program with the option — p (strictly speaking, it is 
sufficient to use this option only when linking the program.) Then run the program, which 
allocates extra memory to hold the profile data, and (provided the program terminates nor- 
mally or calls exit (2)) records the data in a file at the end of execution. 

The environment variable PROFDIR determines the name of the pc-sampling data file and 
determines whether pc-sampling takes place: if it is not set, the pc-sampling data file is named 
"mon.out"; if it is set to the empty string, no profiling occurs; if it is set to a non-empty string, 
the file is named "string/pid.progname," where "pid" is the process id of the executing program 
and "progname" is the program's name, as it appears in argv[0]. The subdirectory "string" must 
already exist. 

After running your program, use prof to anal}^e the pc-sampling data file. 

For example: 

cc -c myprog.c 

cc -p -o myprog myprog.o 

myprog (generates "mon.out") 

prof myprog mon.out 

When you use prof for pc-sampling, the program name defaults to a. out and the pc-sampHng 
data file name defaults to mon.out; if you specify more than one pc-sampling data file, prof 
reports the sum of the data. 

Using basic-block counting 

To use basic-block counting, compile your program without the option —p. Use pixie (1) to 
translate your program into a profiling version and generate a file, whose name ends in 
".Addrs", containing block addresses. Then run the profiling version, which (assuming the 
program terminates normally or calls exit{2)) will generate a file, whose name ends in 
".Counts", containing block counts. Then use prof with the -pixie option to analyze the 
bbaddrs and bbcounts files. Notice that you must tell prof the name of your original program, 
not the name of the profiling version. 
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For example: 

cc -c myprog.c 

cc -0 myprog myprog.o 

pme -0 myprog. pixie myprog (generates "myprog.Addrs") 

myprog.pixie (generates "myprog. Counts") 

prof "pixie myprog myprog.Addrs myprog.Counts 

When you use prof with the "^pixie option, the program name defaults to a, out, the bbaddrs 
file name defaults to "program^ame. Addrs'\ and the bbcounts file name defaults to 
yrogram jname. Connts" , If you specify more than one bbcounts file (never specify more than 
one bbaddrs file), prof reports the sum of the data, "--note '^comment string'' If you use this 
argument, the '^comrnent string'' appears near the beginning of the listing as a comment. 

Options to prof 

For each prof option, you need type only enough of the name to distinguish it from the other 
options (usually the first character is sufficient). Unless otherwise noted, each part of the list- 
ing operates only on the set of procedures that results from the combination of the —exclude 
and "'only options. 

If the options you specify would neither produce a Hsting nor generate a file, prof uses —pro- 
cedures plus "^heavy by default, 

■^pixie Selects pixie mode, as opposed to pc-sampling mode, 

-^procediires 

Reports time spent per procedure (using data obtained from pc-sampling or basic- 
block counting; the listing tells which one). For basic-block counting, this option also 
reports the number of invocations per procedure. 

■^hcavy 

Reports the most heavily used lines in descending order of use (requires basic-block 
counting). 

"^■llnes Like --heavy, but gives the lines in order of occurrence. 

"-invocations 

For each procedure, reports how many times the procedure was invoked from each of 
its possible callers (requires basic-block counting). For this listing, the --exclude and 
-ronly options apply to callees, but not to callers. 

-*3Kero Prints a li^t of procedures that were never invoked (requires basic-block counting). 

^testcoverage 

Reports all Unes that never executed (requires basic-block counting). 

--feedback ^/en^me 

Produces a file with information that the compiler system can use to decide what parts 
of the program will benefit most from global optimization and what parts will benefit 
most from in-line procedure substitution (requires basic-block counting). See 
umerg^{l) 2^VLduopt{V), 

•^m^rg^ filename 

Sums the pc-sampling data files (or, in pixie mode, the bbcounts files) and writes the 
result into a new file with the specified name. The —only and —exclude options have 
no affect on the merged data. 

^only procedurejname 

If you use one or more -"only options, the profile listing includes' only the named pro- 
cedures, rather than the entire program. If any option uses an uppercase "O" for 
"Only," prof uses only the named procedures, rather than the entire program, as the 
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base upon which it calculates percentages. 

—exclude procedure_name 

If you use one or more —exclude options, the projfiler omits the specified procedure 
and its descendents from the listing. If any option uses an uppercase "E" for 
"Exclude/' prof also omits that procedure from the base upon which it calculates per- 
centages. 

—clock megahertz 

Alters the appropriate parts of the listing to reflect the clock speed of the CPU. If you 
do not specify megfl/zerfz, it defaults to "8.0". 

—quit n 

Truncates the —procedures and —heavy Ustings. It can truncate after n lines (if n is an 
integer), after the first entry that represents less than n percent of the total (if n is fol- 
lowed immediately by a "%" character), or after enough entries have been printed to 
account for n percent of the total (if n is followed immediately by "cum%"). For 
example, "-quit 15" truncates each part of the Hsting after 15 lines of text, "-quit 15%" 
truncates each part after the first line that represents less than 15 percent of the whole, 
and "-quit 15cum%" truncates each part after the line that brought the cumulative per- 
centage above 15 percent. 

FILES 

crtO.o normal startup code 

mcrtO.o startup code for pc-sampling 

libprofl.a library for pc-sampling 

mon.out default pc-sampling data file 

SEE ALSO 

monitor(3), profil(2), pixie(2), cc(l), pc(l), f77(l), as(l). The MIPS Languages Programmer's 
Guide, 

FEATURES 

Provided you do not use —pixie, prof processes "mon.out" files produced by earUer versions of 
the compiler system using the obsolete — p2 or — p3 options. 

BUGS 

Prof does not yet take into account interactions among floating-point instructions. 



MIPS Computer Systems, Inc. February 13, 1989 Page 3 



PTX ( 1-BSD ) RISC/os Programmer's Reference PTX ( 1-BSD ) 



NAME 

ptx - permuted index 

SYNOPSIS 

ptx [ Option ].. . [ input [ output ] ] 

DESCRIPTION 

ptx generates a permuted index to file input on file output (standard input and output default), 
It has three phases: the first does the permutation, generating one line for each keyword in an 
input line. The keyword is rotated to the front. The permuted file is then sorted. Finally, the 
sorted lines are rotated so the keyword comes at the middle of the page, ptx produces output 
in the form: 

.XX "tail" "before keyword" "keyword and after" "head" 

where .xx may be an nroff or troff{l) macro for user-defined formatting. The before keyword 
and keyword and after fields incorporate as much of the line as will fit around the keyword 
when it is printed at the middle of the page. Tail and head, at least one of which is an empty 
string "", are wrapped-around pieces small enough to fit in the unused space at the opposite 
end of the line. When original text must be discarded, V marks the spot. 

The following options can be applied: 

—f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line length is 100 characters. 

«-w n Use the next argument, n, as the width of the output line. The default line length is 72 
characters. 

—g n Use the next argument, n, as the number of characters to allow for each gap among 
the four parts of the line as finally printed. The default gap is 3 characters. 

— o only 

Use as keywords only the word? given in the only file. 

—i ignore 

Do not use as keywords any words given in the ignore file. If the -^i and —o options 

are missing, use /i/5r/ft'&/dg/2 as the 2gn(?re file. 

-=b break 

Use the characters in the break file to separate words. In any case, tab, newline, and 
space characters are always used as break characters. 

—r Take any leading nonblank characters of each input line to be a reference identifier 
(as to a page or chapter) separate from the text of the line. Attach that identifier as a 
5th field on each output line. 

The index for this manual was generated using ptx. 



FILES 



BUGS 



/usr/bin/sort 
/usr/lib/eign 

Line length counts do not account for overstriking or proportional spacing. 



( 
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NAME 

ratfor - rational Fortran dialect 

SYNOPSIS 

ratfor [ option ,.. ] [ filename ... ] 

DESCRIPTION 

ratfor converts a rational dialect of Fortran into ordinary irrational Fortran, ratfor provides 
control flow constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

} 

loops: while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 

free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment 

translation of relationals: 

>, >=^, etc., become .GT., .GE., etc. 

return (expression) 

returns expression to caller from function 

define: define name replacement 

include: 

include filename 

ratfor is best used with/77(l). 

SEE ALSO 

f77(l) 

B. W. Kemighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

refer - find and insert literature references in documents 

SYNOPSIS 

refer [ '-'^][ -h] [ -c][ -e][ --fn] [-^kx][ -lm,n ] [ --n ] [ --p bib ] [ --nkeys ] [ --BLm ] [ 
--F][-»S][file...] 

DESCRIPTION 

- refer is a preprocessor for nrojf or troff{l) that finds and formats references for footnotes or 
endnotes. It is also the base for a series of programs designed to index, search, sort, and 
print stand-alone bibUographies, or other data entered in the appropriate form. 

Given an incomplete citation with sufficiently precise keywords, refer will search a biblio- 
graphic database for references containing these keywords anywhere in the title, author, jour- 
nal, etc. The input file (or standard input) is copied to standard output, except for lines 
between .[ and ,] delimiters, which are assumed to contain keywords, and are replaced by 
information from the bibliographic database. The user may also search different databases, 
override particular fields, or add new fields. The reference data, from whatever source, are 
assigned to a set of troff strings. Macro packages such as ms(7) print the finished reference 
text from these strings. By default references are flagged by footnote numbers. 

The following options are available: 

"-an Reverse the first n author names (Jones, J. A. instead of J. A. Jones). If n is omitted 
all author names are reversed. 

™"fo Bare mode: do not put any flags in text (neither numbers nor labels). 

"^^ckeys 

Capitalize (with Caps Small Caps) the fields whose key-letters are in keys, 

— e Instead of leaving the references where encountered, accumulate them until a sequence 
of the form 

•[ 

$LIST$ 

•] 
is encountered, and then write out all references collected so far. Collapse references 
to same source. 

— fi^ Set the footnote number to n instead of the default of 1 (one). With labels rather than 
numbers, this flag is a no-op. 

"~kx Instead of numbering references, use labels as specified in a reference data Une begin- 
ning %x; by default x is L. 

Instead of numbering references, use labels made from the senior author's last name 
and the year of publication. Only the first m letters of the last name and the last n 
digits of the date are used. If either m or n is omitted the entire name or date respec- 
tively is used. 

-•ii Do not search the default file /usr/dict/papers/Ind. K there is a REFER environment 
variable, the specified file will be searched instead of the default file; in this case the 
— n flag has no effect. 

— p bib 

Take the next argument bib as a file of references to be searched. The default file is 
searched last. 

"^Bkeys 

Sort references by fields whose key-letters are in the keys string; permute reference 
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numbers in text accordingly. Implies -e. The key-letters in keys may be followed by a 
number to indicate how many such fields are used, with + taken as a very large 
number. The default is AD which sorts on the senior author and then date; to sort, for 
example, on all authors and then title, use -sA+T. 

-B/.m 

Bibliography mode. Take a file composed of records separated by blank lines, and turn 
them into troff input. Label / will be turned into the macro .m with / defaulting to %X 
and .m defauhing to .AP (annotation paragraph). 

-P Place punctuation marks .,:;?! after the reference signal, rather than before. (Periods 
and commas used to be done with strings.) 

— S Produce references in the Natural or Social Science format. 

To use your own references, put them in the format described below. They can be searched 
more rapidly by running mdxbib{l) on them before using refer; failure to index results in a 
linear search. When refer is used with the eqn, neqn or tbl preprocessors refer should be first, 
to minimize the volume of data passed through pipes. 

The re/er preprocessor and associated programs expect input from a file of references com- 
posed of records separated by blank fines. A record is a set of lines (fields), each containing 
one kind of information. Fields start on a line beginning with a "%", followed by a key- 
letter, then a blank, and finally the contents of the field, and continue until the next line start- 
ing with "%". The output ordering and formatting of fields is controlled by the macros 
specified for nroffltroff (for footnotes and endnotes) or roffbih (for stand-alone bibliogra- 
phies). For a list of the most common key-letters and their corresponding fields, see add- 
bib(l). An example of a refer entry is given below. 

EXAMPLE 

%A M. E. Lesk 

%T Some Applications of Inverted Indexes on the UNIX System 

%B UNIX Programmer's Manual 

%V 2b 

%I Bell Laboratories 

%C Murray Hill, NJ 

%D 1978 

FILES 

/usr/dict/papers directory of default publication lists 
/usr/lib/refer directory of companion programs 

SEE ALSO 

addbib(l), sortbib(l), roffbib(l), indxbib(l), lookbib(l) 

AUTHOR 

Mike Lesk 

BUGS 

Blank spaces at the end of fines in bibliography fields will cause the records to sort and 
reverse incorrectly. Sorting large numbers of references causes a core dump. 
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NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev [ file ] . . , 

DESCRIPTION 

rev copies the named files to the standard output, reversing the order of characters in every 
line. If no file is specified, the standard input is copied. 
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NAME 

rm, rmdir - remove (unlink) files or directories 

SYNOPSIS 

nn[-f][-r][-i][-]file... 

rmdir dir ... 

DESCRIPTION 

" rm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a file requires write permission in its directory, but 
neither read nor write permission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are 
printed and a line is read from the standard input. If that line begins with 'y' the file is 
deleted, otherwise the file remains. No questions are asked and no errors are reported when 
the — f (force) option is given. 

If a designated file is a directory, an error comment is printed unless the optional argument -r 
has been used. In that case, rm recursively deletes the entire contents of the specified direc- 
tory, and the directory itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, 
whether to examine each directory. 

The null option - indicates that all the arguments following it are to be treated as file names. 
This allows the specification of file names starting with a minus. 

rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

rm(l), unlink(2), rmdir(2) 
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NAME 

roffbib - run off bibliographic database 

SYNOPSIS 

roffbib [■-€][ --h ][ -n ][ -o ][ -r ][ "-S ] [ -Tterm ] [ -x ] [ -m mac ][•-■¥][ -Q ] [ file 

DESCRIPTION 

roffbib prints out all records in a bibliographic database, in bibliography format rather than as 
footnotes or endnotes. Generally it is used in conjunction with sortbib : 

sortbib database | roffbib 

roffbib accepts most of the options understood by nroff{l)^ most importantly the --T flag to 
specify terminal type. 

K abstracts or comments are entered following the %X field key, roffbib will format them into 
paragraphs for an annotated bibliography. Several %X fields may be given if several annota- 
tion paragraphs are desired. The "-x flag will suppress the printing of these abstracts. 

A user-defined set of macros may be specified after the »-m ojption. There should be a space 
between the '-m and the macro filename. This set of macros will replace the ones defined in 
/usr/lib/tmac/tmac.bib. The ^V flag wiU send output to the Versatec; the — Q flag wiU queue 
output for the phototypesetter. 

Four command-line registers control formatting style of the bibliography, much like the 
number registers of ms{7). The command-line argument "^rNl will number the references 
starting at one (1). The flag — rV2 will double space the bibliography, while — rVl wiU double 
space references but single space annotation paragraphs. The line length can be changed from 
the default 6.5 inches to 6 inches with the — rL6i argument, and the page offset can be set 
from the default of to one inch by specifying — rOli (capital O, not zero). Note: with the 
—V and -»Q flags the default page offset is already one inch. 

FILES 

/usr/lib/tmac/tmac.bib file of macros used by nroff/troff 

SEE ALSO 

refer(l), addbib(l), sortbib(l), indxbib(l), lookbib(l) 

BUGS 

Users have to rewrite macros to create customized formats. 
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NAME 

sees - front end for the SCCS subsystem 

SYNOPSIS 

sees [ — r ] [ —dpath ] [ -"ppath ] command [ flags ] [ args ] 

DESCRIPTION 

SCCS is a front end to the SCCS programs that helps them mesh more cleanly with the rest of 
UNIX. It also includes the capability to run "set user id'' to another user to provide addi- 
tional protection. 

Basically, sees runs the command with the specified ^^gj and args. Each argument is normally 
modified to be prepended with "SCCS/s.". 

Flags to be interpreted by the sees program must be before the command argument. Flags to 
be passed to the actual SCCS program must come after the command argument. These flags 
are specific to the command and are discussed in the documentation for that command. 

Besides the usual SCCS commands, several *'pseudo-commands" can be issued. These are: 



edit 
delget 



deledit 



create 



fix 



clean 



unedit 



info 



check 



Equivalent to "get -e". 

Perform a delta on the named files and then get new versions. The new ver- 
sions will have id keywords expanded, and will not be editable. The -m, -p, 
-r, -s, and -y flags wiU be passed to delta, and the -b, -c, -e, -i, -k, ~1, -s, 
and -X flags wiU be passed to get. 

Equivalent to "delgef' except that the "get'' phase includes the "^-e" flag. 
This option is useful for making a "checkpoint" of your current editing phase. 
The same flags will be passed to delta as described above, and all the flags 
listed for "get" above except -e and -k are passed to "edit". 

Creates an SCCS file, taking the initial contents from the file of the same 
name. Any flags to "admin" are accepted. If the creation is successful, the 
files are renamed with a comma on the front. These should be removed when 
you are convinced that the SCCS files have been created successfully. 

Must be followed by a — r flag. This command essentially removes the named 
delta, but leaves you with a copy of the delta with the changes that were in it. 
It is useful for fixing smaU compiler bugs, etc. Since it doesn't leave audit 
trails, it should be used carefully. 

This routine removes everything from the current directory that can be 
recreated from SCCS files. It will not remove any files being edited. If the 
—b flag is given, branches are ignored in the determination of whether they are 
being edited; this is dangerous if you are keeping the branches in the same 
directory. 

This is the opposite of an "edit" or a "get -e". It should be used with 
extreme caution, since any changes you made since the get will be irretrievably 
lost. 

Gives a listing of aU files being edited. If the — b flag is given, branches (i.e., 
SID's with two or fewer components) are ignored. If the — u flag is given (with 
an optional argument) then only files being edited by you (or the named user) 
are listed. 

Like "info" except that nothing is printed if nothing is being edited, and a 
non-zero exit status is returned if anything is being edited. The intent is to 
have this included in an "install" entry in a makefile to insure that everything 
is included into the SCCS file before a version is instaUed. 
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tell Gives a newline-separated list of the files being edited on the standard output. 

Takes the -b and -^u flags like ''info'' and "check". 

diffs Gives a ''difP' Hsting between the current version of the program(s) you have 

out for editing and the versions in SCCS format. The -r^ -^c, — ij —x^ and -^t 
flags are passed to get; the -I, -s, —e, -f, -h, and --b options are passed to 
diff,. The --C flag is passed to diff as --c, 

print This command prints out verbose information about the named files.- 

The -r flag runs sees as the real user rather than as whatever effective user sees is '^set user id'' 
to. The -d flag gives a root directory for the SCCS files. The default is the current directory. 
The --p flag defines the pathname of the directory in which the SCCS files will be found; 
"SCCS" is the default. The -p flag differs from the --d fl^ in that the -^d argument is 
prepended to the entire pathname and the -p argument is inserted before the final com- 
ponent of the pathname: For example, "sees -d/x -py get a/b" will convert to ''get 
/x/a/y/s.b". The intent here is to create aliases such as "alias syssccs sees -d/usr/src" which 
will be used as "syssccs get cmd/who.c". Also, if the environment variable PROJECT is set, 
its value is used to determine the -d flag. If it begins with a slash, it is taken directly; other- 
wise, the home directory of a user of that name is examined for a subdirectory "src" or 
"source". If such a directory is found, it is used. 

Certain commands (such as admin) cannot be run "set user id" by all users, since this would 
allow anyone to change the authorizations. These commands are always run as the real user. 

EXAMPLES 

To get a file for editing, edit it, and produce a new delta: 

sees get -e file.c 

ex file.c 

sees delta file.c 

To get a file from another directory: 

sees -p/usr/src/sccs/s. get ccx 
or 

sees get /usr/src/sccs/s.cc.c 
To make a delta of a large number of files in the current directory: 

sees delta ^x 
To get a list of files being edited that are not on branches: 

sees info -b 
To delta everything being edited by you: 

sees delta 'sees tefl -u' 

In a makefile, to get source files from an SCCS file if it does not already exist: 

SRCS - <Ust of source files> 
$(SRCS): 

sees get $(REL) $@ 

SEE ALSO 

admin(SCCS), chghist(SCCS), comb(SCCS), delta(SCCS), get(SCCS), help(SCCS), 

prt(SCCS), rmdel(SCCS), sccsdiff(SCCS), what(SCCS) 

Eric Allman, An Introduetion to the Source Code Control System 
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BUGS 

It should be able to take directory arguments on pseudo-commands like the SCCS commands 
do. 
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NAME 

size - prints the section size of an object file 

SYNOPSIS 

size [^o "d -X -A »B -V] [ filel •.. fileN ] 

DESCRIPTION 

The size command prints information about the text, rdata, data, sdata, bss and sbss sections 
of each file. The file can be an object or an archive, If you don't specify a file, size uses 
a,out as the'default. 

The -o, -X, and -d options print the size in octal, hexadecimal, and decimal, respectively. 

The -A and -B options specify AT&T System V style output or Berkeley (4.3BSD) style out- 
put, respectively. The version of UNIX running at your site determines the default. System V 
style, which is more verbose than Berkeley, dumps the headers of each section. The Berkeley 
version prints size information for each section, regardless of whether the file exists, and 
prints the total in hexadecimal and decimal. 

The -V option prints the version of size that you're using. 

SEE ALSO 

MIPS Languages Programmer Guide 
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NAME 

soelim - eliminate .so's from nroff input 

SYNOPSIS 

soelim [ file ... ] 

DESCRIPTION 

soelim reads the specified files or the standard input and performs the textual inclusion 
implied by the nroff directives of the form 

.so somefile 

when they appear at the beginning of input lines. This is useful since programs such as tbl do 
not normally do this; it allows the placement of individual tables in separate files to be run as 
a part of a large document. 

An argument consisting of a single minus (— ) is taken to be a file name corresponding to the 
standard input. 

Note that inclusion can be suppressed by using '"' instead of '.\ i.e. 

"so /usr/lib/tmac.s 
A sample us;^e of soelim would be 

soelim exum?.n | tbl | nroff -ms | col | Ipr 

SEE ALSO 

colcrt(l), more(l) 

BUGS 

The format of the source commands must involve no strangeness - exactly one blank must 
precede and no blanks follow the file name. 
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NAME 

sort - sort or merge files 

SYNOPSIS 

sort [ -mubdfinrtx ] [ ^-posl [ -pos2 ] ] ... [ -o name ] [ -T directory ] [ name ] ... 

DESCRIPTION 

^orr sorts lines of all the named files together and writes the result on the standard output. 
The name '- means the standard input. If no input files are named, the standard input is 
sorted. 

The default sort key is an entire line. Default ordering is lexicographic by bytes in machine 
collating sequence. The ordering is affected globally by the following options, one or more of 
which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons. 

d 'Dictionary' order: only letters, digits and blanks are significant in comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is sorted by arithmetic value. Option n implies 
option b. 

r Reverse the sense of comparisons. 

tx Tab character' separating fields is x » 

The notation A-posl -/?052 restricts a sort key to a field beginning at posl and ending just 
before posl. Posl and posl each have the form m.n, optionally followed by one or more of | 

the flags bdfiiir, where m tells a number of fields to skip from the beginning of the line and n ^ 

tells a number of characters to skip further. If any flags are present they override all the glo- 
bal ordering options for this key. If the b option is in effect n is counted from the first non- 
blank in the field; b is attached independently to posl, A missing .n means .0; a missing 
-^posl means the end of the line. Under the •^ix option, fields are strings separated by x; oth- 
erwise fields are nonempty nonblank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; give no output unless 
the file is out of sort. 

m Merge only, the input files are already sorted. 

o The next argument is the name of an output file to use instead of the standard output. 
This file may be the same as one of the inputs. 

T The next argument is the name of a directory in which temporary files should be made. 

u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do 
not participate in this comparison. 

EXAMPLES 

Print in alphabetical order all the unique spellings in a list of words. Capitalized words differ 
from uncapitalized. 

sort -u +0f +0 Ust 
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Print the password file (passwd (5)) sorted by user id number (the 3rd colon-separated IB eld), 

sort -t: +2n /etc/passwd 

Print the first instance of each month in an already sorted file of (month day) entries. The 
options — um with just one input file make the choice of a unique representative from a set of 
equal lines predictable. 

sort -um +0 -1 dates 

FILES 

/usr/tmp/stm*, /tmp/* first and second tries for temporary files 

SEE ALSO 

uniq(l), comm(l), rev(l), join(l) 

DLVGNOSTICS 

Comments and exits with nonzero status for various trouble conditions and for disorder 
discovered under option ---c. 

BUGS 

Very long lines (>1023 characters) are silently truncated. 
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NAME 

sortbib - sort bibliographic database 

SYNOPSIS 

sortbib [ -sKEYS ] database ... 

DESCRIPTION 

sortbib sorts files of records containing refer key-letters by user-specified keys. Records may 
be separated by blank lines, or by .[ and .] delimiters, but the two styles may not be mixed 
together. This program reads through each database and pulls out key fields, which are sorted 
separately. The sorted key fields contain the file pointer, byte offset, and length of 
corresponding records. These records are delivered using disk seeks and reads, so sortbib may 
not be used in a pipeline to read standard input. 

By default, sortbib alphabetizes by the first %A and the %D fields, which contain the senior 
author and date. The --s option is used to specify new KEYS, For instance, — sATD will sort 
by author, title, and date, while ---sA+D will sort by all authors, and date. Sort keys past the 
fourth are not meaningful. No more than 16 databases may be sorted together at one time. 
Records longer than 4096 characters will be truncated. 

sortbib sorts on the last word on the %A line, which is assumed to be the author's last name. 
A word in the final position, such as "jr.'" or "ed.", will be ignored if the name beforehand 
ends with a comma. Authors with two-word last names or unusual constructions can be 
sorted correctly by using the nrojf convention "W in place of a blank. A %Q field is con- 
sidered to be the same as %A, except sorting begins with the first, not the last, word, sortbib 
sorts on the last word of the %D line, usually the year. It also ignores leading articles (like 
"A" or "The") when sorting by titles in the %T or %J fields; it will ignore articles of any 
modem European language. If a sort-significant field is absent from a record, sortbib places ^ 

that record before other records containing that field. f 

SEE ALSO 

refer(l), addbib(l), roffbib(l), indxbib(l), lookbib(l) 

AUTHORS 

Greg Shenaut, Bill Tuthill 

BUGS 

Records with missing author fields should probably be sorted by title. 
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NAME 

spell, spelliiiy spellout - find spelling errors 

SYNOPSIS 

spell [ -V ] [ -b ] [ -X ] [ -"d hlist ] [ -s hstop ] [ -h spellhist ] [ file ] ... 

spellin [ list ] 

spellout [ — d ] list 

DESCRIPTION 

spell collects words from the named documents, and looks them up in a spelling list. Words 
that neither occur among nor are derivable (by applying certain inflections, prefixes or 
suffixes) from words in the spelling list are printed on the standard output. If no files are 
named, words are collected from the standard input. 

spell ignores most trojfy tbl and eqn(l) constructions. 

Under the — v option, all words not Uterally in the spelling list are printed, and plausible 
derivations from spelling list words are indicated. 

Under the — b option, British spelling is checked. Besides preferring centre, colour, speciality, 
travelled, etc., this option insists upon -ise in words like standardise, Fowler and the OED to 
the contrary notwithstanding. 

Under the — x option, every plausible stem is printed with '=^' for each word. 

The spelling list is based on many sources. While it is more haphazard than an ordinary dic- 
tionary, it is also more effective with proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine and chemistry is light. 

The auxiliary files used for the spelling Ust, stop list, and history file may be specified by argu- 
ments following the -d, -s, and -h options. The default files are indicated below. Copies 
of all output may be accumulated in the history file. The stop Ust filters out misspellings (e.g. 
thier=thy-y+ier) that would otherwise pass. 

Two routines help maintain the hash fists used by spell Both expect a set of words, one per 
line, from the standard input, spellin combines the words from the standard input and the 
preexisting list file and places a new Ust on the standard output. If no list file is specified, the 
new Ust is created from scratch, spellout looks up each word from the standard input and 
prints on the standard output those that are missing from (or present on, with option ~d) the 
hashed list file. For example, to verify that hookey is not on the default speUing Ust, add it to 
your own private Ust, and then use it with spell, 

echo hookey | spellout /usr/dict/hUsta 

echo hookey j spelUn /usr/dict/hUsta > myhlist 

spell -d myhlist huckfinn 



FILES 



/usr/dict/hlist[ab] hashed spelUng lists, American & British, default for -d 

/usr/dict/hstop hashed stop Ust, default for — s 

/dev/nuU history file, default for -h 

/tmp/spell.$$* temporary files 

/usr/lib/spell 
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SEE ALSO V 

deroff(l), sort(l), tee(l), sed(l) 

BUGS 

The spelling list's coverage is uneven; new installations will probably wish to monitor the out- 
put for several months to gather local additions, Spellout is Hmited to a maximum of 30 char- 
acters per word - words greater than 30 characters are broken and treated as two words, Brit- 
ish spelling was done by an American. 
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NAME 

strip - remove symbols and relocation bits 

SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to the output of the 
assembler and loader. This is useful to save space after a program has been debugged. 

The effect of strip is the same as use of the — s option of Id . 

FILES 

/tmp/stm? temporary j&le 

SEE ALSO 

ld(l) 
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NAME 

stty - set terminal options 

SYNOPSIS 

stty [ option . . . ] 

DESCRIPTION 

Stty sets certain I/O options on the current output terminal, placing its output on the diagnos- 
tic output. - With no argument, it reports the speed of the terminal and the settings of the 
options which are different from their defaults. Use of one of the following options modifies 
the output as described: 

all All normally used option settings are reported. 

everything 

Everything stty knows about is printed. 

speed The terminal speed alone is printed on the standard output. 

size The terminal (window) sizes are printed on the standard output, first rows and then 

columns. 



c 



The option strings are selected from the following set: 

allow even parity input 

disallow even parity input 

allow odd parity input 

disallow odd parity input 

raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed 

back) 

negate raw mode 

same as ''-raw^ 

make each character available to read (2) as received; no erase and kill processing, 

but all other processing (interrupt, suspend, ...) is performed 

make characters available to read only when newline is received 

allow carriage return for new-line, and output CR-LF for carriage return or new-line 

accept only new-line to end lines 

echo back every character typed 

do not echo characters 

map upper case to lower case 

do not map case 

enable flow control, so that the system sends out the stop character when its inter- 
nal queue is in danger of overflowing on input, and sends the start character when 

it is ready to accept further input 

disable flow control 

replace tabs by spaces when printing 

preserve tabs 

set erase and kill characters to # and @ 
For the following commands which take a character argument c, you may also specify c as the 
"u'' or ''undef ', to set the value to be undefined. A value of ""x'', a 2 character sequence, is 
also interpreted as a control character, with ""?" representing delete. 

set erase character to c (default '#', but often reset to "H.) 

set kill character to c (default *@', but often reset to "U.) 

set interrupt character to c (default DEL or "? (delete), but oftjen reset to "C.) 

set quit character to c (default control \.) 

set start character to c (default control Q.) 



even 
—even 
odd 
-"odd 

raw 

™raw 

cooked 

cbreak 

-"cbreak 

-nl 

nl 

echo 

—echo 

lease 

—lease 

tandem 



—tandem 
—tabs 
tabs 
ek 



erase c 
killc 
intr c 
quit c 
start c 
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stop c set stop character to c (default control S.) 

eofc set end of file character to c (default control D.) 

brk c set break character to c (default undefined.) This character is an additional charac- 

ter causing wakeup. 

crO crl cr2 cr3 

select style of delay for carriage return (see ioctl(2)) 

nlO nil nl2 nD 

select style of delay for linefeed 

tabO tabl tab2 tab3 

select style of delay for tab 

ffO ttl select style of delay for form feed 

bsO bsl select style of delay for backspace 

tty33 $et all modes suitable for the Teletype Corporation Model 33 terminal. 

tty37 set all modes suitable for the Teletype Corporation Model 37 terminal. 

ytOB set all modes suitable for Digital Equipment Corp. VT05 terminal 

dee set all modes suitable for Digital Equipment Corp. operating systems users; (erase, 

kill, and interrupt characters to "?, "U, and "C, decctlq and '*newcrt".) 

tn3Q0 set all modes suitable for a General Electric TermiNet 300 

ti700 set all modes suitable for Texas Instruments 700 series terminal 

tek set aU modes suitable for Tektronix 4014 terminal 

hang up phone line immediately 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if possible. (These are the speeds sup- 
ported by the DH-11 interface). 

rows n The terminal size is recorded as having n rows. 

columns n 

The terminal size is recorded as having n columns. 

cols n is an alias for columns. 

A teletype driver which supports the job control processing of csh(l) and more functionaUty 
than the basic driver is fully described in ^0^(4). The following options apply only to it. 

new Use new driver (switching flushes typeahead). 

crt Set options for a CRT (crtbs, ctlecho and, if >= 1200 baud, crterase and crtkill.) 

crtbs Echo backspaces on erase characters. 

prterase For printing terminal echo erased characters backwards within "\'' and "/". 

crterase Wipe out erased characters with "backspace-space-backspace." 

—crterase Leave erased characters visible; just backspace. 

crtkill Wipe out input on like kill ala crterase. 

—crtkill Just echo line kill character and a newlitie on line kill. 

ctlecho Echo control characters as ""jt" (and delete as ""?".) Print two backspaces follow- 
ing the EOT character (control D). 

—ctlecho Control characters echo as themselves; in cooked mode EOT (control-D) is not 
echoed. 

decctlq After output is suspended (normally by "S), only a start character (normally "Q) 
will restart it. This is compatible with DEC's vendor suppUed systems. 

—decctlq After output is suspended, any character typed will restart it; the start character 

will restart output without providing any input. (This is the default.) 
tostop Background jobs stop if they attempt terminal output. 
— tostop Output from background jobs to the terminal is allowed. 
tilde Convert "^" to "'" on output (for Hazeltine terminals). 
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—tilde Leave poor *'~" alone. 

flusho Output is being discarded usually because user hit control O (internal state bit). 

"-flusho Output is not being discarded. 

pendin Input is pending after a switch from cbreak to cooked and will be re-input when a 

read becomes pending or more input arrives (internal state bit). 

—pendin Input is not pending, 

pass8 Passes all 8 bits through on input, in any mode. 

— pass8 Strips the 0200 bit on input except in raw mode. 

mdmbuf Start/stop output on carrier transitions (not implemented), 
— mdmbuf Return error if write attempted after carrier drops. 

litout Send output characters without any processing. 

— litout Do normal output processing, inserting delays, etc. 

nohang Don't send hangup signal if carrier drops. 

—nohang Send hangup signal to control process group when carrier drops. 

etxack Diablo style etx/ack handshaking (not implemented). 

The following special characters are applicable only to the new teletype driver and are not nor- 
mally changed. 

susp c set suspend process character to c (default control Z). 

dsusp c set delayed suspend process. character to c (default control Y). 

rpmt c set reprint line character to c (default control R). 

flush c set flush output character to c (default control O). 

werase c set word erase character to c (default control W). 

biextc set literal next character to c (default control V). 

SEE ALSO 

ioctl(2), tabs(l), tset(l), tty(4) 
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NAME 

SU, ssu - substitute user id temporarily 

SYNOPSIS 

SU [ — f ] [ — ] [ — e ] [ — c ] [ userid [ command [ args.,, ] ] ] 

DESCRIPTION 

SU demands the password of the specified userid^ and if it is given, changes to that userid and 
invokes the shell (unless — c is given, see below) without changing the current directory. 
Unless the —e option is given (see below), the user environment is unchanged except for 
HOME and SHELL, which are taken from the password file for the user being substituted 
(see environ (7)), The new user ID stays in force until the Shell exits. 

If no userid is specified, "root" is assumed. Only users in the "wheeF' group (group 0) or in 
the file /etc/su_people (described below) can su to "root", even with the root password (this 
can be overridden by changing su to hiave group wheel and turning on the set-group-id permis- 
sion). To remind the super-user of his responsibilities, the Shell substitutes '#' for its usual 
prompt. 

The command ssu is a link to su. Executing ssu is the same as executing the command ''su -c 
-e root'. 

If the user tries to su to root and the root account has a password (as is the preferable case), 
the file /etc/su^eople is read to see if that usemame is allowed to become root without a pass- 
. word. Since this can be dangerous, the file must have owner (root), group wheel (0), and 
mode 0600 (read and write by owner only), or it will be silently ignored. See the manual page 
for su_people(5) for details on this file. 

OPTIONS 

—f Prevents csh(l) from executing the .cshrc fjle; thus making su start up faster. 

— Simulates a full login by executing the shell with name *-sh'. 

-e Do not overwrite any of the environment. This means that the variables HOME and 
SHELL are retained from the original user and that shell is executed. For csh(l) users, 
this means that the aliases are taken from the original user's .cshrc file, which is very con- 
venient. 

•-c If any arguments are given after the usemame, they are executed as a command instead of 
the shell. For example, *su -c root Is' will execute the command ls(l) as root, whereas 'su 
root Is' will execute the command 'csh Is' as root (this is not the same thing). 

FILES 

/etclsu^eople Special permission database 

SEE ALSO 

sh(l), csh(l), su_people(5) 
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NAME 

talk - talk to another user 

SYNOPSIS 

talk person [ ttyname ] 

DESCRIPTION 

talk is a visual communication program which copies lines from your terminal to that of 
another user. 

If you wish to talk to someone on you own machine, then person is just the person's login 
name. If you wish to talk to a user on another host, then person is of the form : 

host/user or 
hostMser or 
hostmser or 
user@host 

though host@user is perhaps preferred. 

If you want to talk to a user who is logged in more than once, the ttyname argument may be 
used to indicate the appropriate terminal name. 

When first called, it sends the message 

Message from talk.Daemon@his_machine... 

talk: connection requested by yourjaame@your_machine. 

talk: respond with: talk your_name@your„machine 

to the user you wish to talk to. At this point, the recipient of the message should reply by typ- 
ing 

talk your_name@your_machine 

It doesn't matter from which machine the recipient repUes, as long as his login-name is the 
same. Once communication is estabUshed, the two parties may type simultaneously, with their 
output appearing in separate windows. Typing control L will cause the screen to be reprinted, 
while your erase, kill, and word kill characters will work in talk as normal To exit, just type 
your interrupt character; talk then moves the cursor to the bottom of the screen and restores 
the terminal. 

Permission to talk may be denied or granted by use of the mesg command. At the outset talk- 
ing is allowed. Certain commands, in particular nroff and pr{l) disallow messages in order to 
prevent messy output. 

FILES 

/etc/hosts to find the recipient's machine 

/etc/utmp to find the recipient's tty 

SEE ALSO 

mesg(l), who(l), mail(l), write(l) 

BUGS 

The version of talk{l) released with 4.3BSD uses a protocol that is incompatible with the pro- 
tocol used in the version released with 4.2BSD. 
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NAME V 

tbl - format tables for nroff or troff 

SYNOPSIS 

tbl [ files ] ... 

DESCRIPTION 

tbl is a preprocessor for formatting tables for nroff or troff {1). The input files are copied to 
the standard output, except for lines between and are reformatted. Details are given in the 
rW(l) reference manual. 

EXAMPLE 

As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 

.TS 

CSS 

CCS 

c c c ■ 

Inn. 

Household Population 

TownXtHouseholds 

\tNumber\tSize 

Bedminster\t789\t3.26 

Bernards Twp.\t3087\t3. 74 

Bernardsville\t2018\t3 30 

Bound Brook\t3425\t3. 04 

Branchburg\tl644\t3 .49 

Bridgewater\t7897\t3.81 f 

Far Hills\t240\t3.19 \ 

.TE 



yields 



Household Population 



Town 


Households 




Number Size 


Bedminster 


789 3.26 


Bernards Twp. 


3087 3.74 


Bemardsville 


2018 330 


Bound Brook 


3425 3.04 


Branchburg 


1644 3.49 


Bridgewater 


7897 3.81 


Far Hills 


240 3.19 



If no arguments are given, tbl reads the standard input, so it may be used as a filter. When tbl 
is used with eqn or neqn the tbl command should be first, to minimize the volume of data 
passed through pipes. 

SEE ALSO 

troff(l), eqn(l) 
M. E. Lesk, TBL. 



i 
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NAME 

tc - photoypesetter simulator 

SYNOPSIS 

tc [ -t ] [ -sN ] [ -pL ] [ file ] 

DESCRIPTION 

tc interprets its input (standard input default) as device codes for a Graphic Systems photo- 
typesetter (cat). The standard output of tc is intended for a Tektronix 4015 (a 4014 terminal 
with ASCII and APL character sets). The sixteen typesetter sizes are mapped into the 4014's 
four sizes; the entire TROFF character set is drawn using the 4014's character generator, using 
overstruck combinations where necessary. Typical usage: 

troff -t file I tc 

At the end of each page tc waits for a newline (empty Ime) from the keyboard before continu- 
mg on to the next page. In this wait state, the command e will suppress the screen erase 
before the next page; sN will cause the next N pages to be skipped; and !line will send line to 
the shell. 

The command line options are: 

-t Don't wait between pages; for directing output into a file. 

-*sN Skip the first N pages. 

-pL Set page length to L. L may include the scale factors p (points), i (inches), c (centim- 
eters), and P (picas); default is picas. 

'-^/ w' Multiply the default aspect ratio, 1,5, of a displayed page by l/w. 
SEE ALSO 

troff(l), plot(lG) 

BUGS 

Font distinctions are lost, 

fc's character set is Umited to ASCII in just one size. 

The aspect ratio option is unbelievable. 
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NAME v. 

tcopy ~ copy a mag tape 

SYNOPSIS 

tcopy src [ dest ] 

DESCRIPTION 

tcopy is designed to copy magnetic tapes. The only assumption made about the tape is that 
there are two tape marks at the end. tcopy with only a source tape specified will print infor- 
mation about the sizes of records and tape files. If a destination is specified, then, a copy will 
be made of the source tape. The blocking on the destination tape will be identical to that 
used on the source tape. Copying a tape will yield the same output as if just printing the sizes. 

SEE ALSO 

mtio(4) 



( 



( 
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NAME 

tip, cu - connect to a remote system 

SYNOPSIS 

tip [ — V ] [ "-speed ] system-name 

tip [ — y ] [ '"'Speed ] phone-number 

cu phone-number [ — t ] [ — s speed ] [ -a acu ] [ —1 line ] [ ■*■# ] 

DESCRIPTION 

tip and cu establish a full-duplex connection to another machine, giving the appearance of 
being logged in directly on the remote cpu. It goes without saying that you must have a login 
on the machine (or equivalent) to which you wish to connect. The preferred interface is tip. 
The cu interface is included for those people attached to the "call UNIX" command of ver- 
sion 7. This manual page describes only rip. 

Typed characters are normally transmitted directly to the remote machine (which does the 
echoing as well). A tilde ('""') appearing as the first character of a line is an escape signal; the 
following are recognized: 

~"D ~. Drop the connection and exit (you may still be logged in on the remote machine). 

'"c [name] Change directory to name (no argument impHes change to your home directory). 

~! Escape to a shell (exiting the shell will return you to tip). 

"> Copy file from local to remote, tip prompts for the name of a local file to transmit. 

~< Copy file from remote to local, tip prompts first for the name of the file to be 

sent, then for a command to be executed on the remote machine. 

""p from [to] 

Send a file to a remote UNIX host. The put command causes the remote UNIX 
system to run the command string "cat > 'to'*', while tip sends it the "from'' file. 
If the "to" file isn't specified the "from" file name is used. This command is actu- 
ally a UNIX specific version of the "~>" command. 

~t from [to] 

Take a file from a remote UNIX host. As in the put command the **to" file 
defaults to the "from" file name if it isn't specified. The remote host executes the 
command string "cat 'from';echo "A" to send the file to tip. 

~| Pipe the output from a remote command to a local UNIX process. The command 

string sent to the local UNIX system is processed by the shell. 

'"% Pipe the output from a local UNIX process to the remote host. The command 

string sent to the local UNIX system is processed by the shell. 

~# Send a BREAK to the remote system. For systems which don't support the neces- 

sary iocti call the break is simulated by a sequence of line speed changes and DEL 
characters. 

~s Set a variable (see the discussion below). 

'^^Z Stop tip (only available with job control). 

"""Y Stop only the "local side" of tip (only available with job control); the "remote 

side" of tip, the side that displays output from the remote host, is left running. 

~? Get a summary of the tilde escapes 

tip uses the file /etc/remote to find how to reach a particular system and to find out how it 
should operate while talking to the system; refer to remote {5) for a full description. Each sys- 
tem has a default baud rate with which to establish a connection. If this value is not suitable, 
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the baud rate to be used may be specified on the command line, e.g. "tip -300 mds''. 

When tip establishes a connection it sends out a connection message to the remote system; the 
default value, if any, is defined in /etc/remote. 

When tip prompts for an argument (e.g. during setup of a file transfer) the line typed may be 
edited with the standard erase and kill characters. A null line in response to a prompt, or an 
interrupt, will abort the dialogue and return you to the remote machine. 

tip guards against multiple users connecting to a remote system by opening modems and termi- 
nal lines with exclusive access, and by honoring the locking protocol used by uucp (IC). 

During file transfers tip provides a running count of the number of Unes transferred. When 
using the ~> and ~< commands, the ^^eofread'^ and *'eofwrite'' variables are used to recognize 
end-of-file when reading, and specify end-of-file when writing (see below). File transfers nor- 
mally depend on tandem mode for flow control. If the remote system does not support tan- 
dem mode, "echocheck'' may be set to indicate tip should synchronize with the remote system 
on the echo of each transmitted character. 

When tip must dial a phone number to connect to a system it will print various messages indi- 
cating its actions, tip supports the DEC DN-11 and Racal-Vadic 831 auto-call-units; the DEC 
DF02 and DF03, Ventel 212+, Racal-Vadic 345X, Bizcomp 1031 and 1032, Hayes SmartMo- 
dem, and Concord Data Systems 224 integral call unit/modems. 

VARIABLES 

tip maintains a set of variables which control its operation. Some of these variable are read- 
only to normal users (root is allowed to change anything of interest). Variables may be 
displayed and set through the "s'' escape. The syntax for variables is patterned after vi(l) and 
Mail{l). Supplying "all" as an argument to the set command displays all variables readable by 
the user. Alternatively, the user may request display of a particular variable by attaching a *?' 
to the end. For example ^^escape?'' displays the current escape character. 

Variables are numeric, string, character, or boolean values. Boolean variables are set merely 
by specifying their name; they may be reset by prepending a '!' to the name. Other variable 
types are set by concatenating an *=' and the value. The entire assignment must not have any 
blanks in it. A single set command may be used to interrogate as well as set a number of vari- 
ables. Variables may be initialized at run time by placing set commands (without the *'~s'' 
prefix in a file Mprc in one's home directory). The —v option causes tip to display the sets as 
they are made. Certain common variables have abbreviations. The following is a list of com- 
mon variables, their abbreviations, and their default values. 

beautify 

(bool) Discard unprintable characters when a session is being scripted; abbreviated be, 

baudrate 

(num) The baud rate at which the connection was established; abbreviated ba. 

dialtimeout 

(num) When dialing a phone number, the time (in seconds) to wait for a connection 
to be estabhshed; abbreviated diaL 

echoeheck 

(bool) Synchronize with the remote host during file transfer by waiting for the echo of 
the last character transmitted; default is off. 

eofread 

(str) The set of characters which signify and end-of-tranmission during a ~< file 
transfer command; abbreviated 6<9/r. 

eofwrite 
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(str) The string sent to indicate end-of-transmission during a ~> jSle transfer com- 
mand; abbreviated eo/w. 

eol 

(str) The set of characters which indicate an end-of~Hne. tip will recognize escape 
characters only after an end-of-line. 

escape 

(char) The command prefix (escape) character; abbreviated es; default value is '^'. 

exceptions 

(str) The set of characters which should not be discarded due to the beautification 
switch; abbreviated ex; default value is "\t\n\f\b". 

force 

(char) The character used to force literal data transmission; abbreviated fo; default 
value is 'P'. 

framesize 

(num) The amount of data (in bytes) to buffer between file system writes when receiv- 
ing files; abbreviated /r. 

host 

(str) The name of the host to which you are connected; abbreviated ho. 

prompt 

(char) The character which indicates and end-oMine on the remote host; abbreviated 
pr; default value is '\n\ This value is used to synchronize during data transfers. The 
count of lines transferred during a file transfer command is based on recipt of this 
character. 

raise 

(bool) Upper case mapping mode; abbreviated ra; default value is off. When this 
mode is enabled, all lower case letters will be mapped to upper case by tip for 
transmission to the remote machine. 

raisechar 

(char) The input character used to toggle upper case mapping mode; abbreviated re; 
default value is '"A'. 

record 

(str) The name of the file in which a session script is recorded; abbreviated rec; 
default value is "tip. record". 

script 

(bool) Session scripting mode; abbreviated sc; default is ojf. When script is true, tip 
will record everything transmitted by the remote machine in the script record file 
specified in record, K the beautify switch is on, only printable ASCII characters will 
be included in the script file (those characters betwee 040 and 0177). The variable 
exceptions is used to indicate characters which are an exception to the normal 
beautification rules. 

tabexpand 

(bool) Expand tabs to spaces during file transfers; abbreviated tab ; default value is 
false. Each tab is expanded to 8 spaces. 

verbose 

(bool) Verbose mode; abbreviated verb; default is true. When verbose mode is 
enabled, tip prints messages while dialing, shows the current number of lines 
transferred during a file transfer operations, and more. 
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SHELL \ 

(str) The name of the shell to use for the ^! command; default value is *Vbin/sh", or 
taken from the environment. 

. HOME 

(str) The home directory to use for the '^c command; default value is taken from the 
environment. 

FILES 

/etc/remote global system descriptions 

/etc/phones global phone number data base 

${REMOTE} private system descriptions 

${PHONES} private phone numbers 

V.tiprc initialization file. 
/usr/spool/locks/LCK..* lock file to avoid conflicts with £^wcp 

DIAGNOSTICS 

Diagnostics are, hopefully, self explanatory. 

SEE ALSO 

remote(5), phones(5) 

BUGS 

The full set of variables is undocumented and should, probably, be paired down. 



( 
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NAME 

tk - paginator for the Tektronix 4014 

SYNOPSIS 

tk[-t][--iV][-pL][file] 

DESCRIPTION 

The output of tk is intended for a Tektronix 4014 terminal, tk arranges for 66 lines to fit on 
the screen, divides the screen into A/^ columns, -and contributes an eight space page offset in 
the (default) single-column case. Tabs, spaces, and backspaces are collected and plotted 
when necessary. Teletype Model 37 half- and reverse-Une sequences are interpreted and plot- 
ted. At the end of each page tk waits for a newline (empty line) from the keyboard before 
continuing on to the next page. In this wait state, the command Icommand will send the com- 
mand to the shell. 

The command line options are: 

— t Don't wait between pages; for directing output into a file. 

— // Divide the screen into N columns and wait after the last column. 

— pL Set page length to L lines. 

SEE ALSO 
pr(l) 
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NAME \ 

tr - translate characters 

SYNOPSIS 

tr [ — cds ] [ stringl [ string2 ] ] 

DESCRIPTION 

tr copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters found in stringl are mapped into the corresponding characters of 
stringl. When stringl is short it is padded to the length of stringl by duplicatmg its last char- 
acter. Any combination of the options -"cds may be used: — c complements the set of charac- 
ters in stringl with respect to the universe of characters whose ASCII codes are 01 through 
0377 octal; -d deletes all input characters in stringl; '-^ squeezes all strings of repeated output 
characters that are in stringl to single characters. 

In either string the notation a -& means a range of characters from a to ft in increasing ASCII 
order. The character *\' followed by 1, 2 or 3 octal digits stands for the character whose 
ASCn code is given by those digits. A '\' followed by any other character stands for that 
character. 

The following example creates a list of all the words in *filel' one per line in 'file2', where a 
word is taken to be a maximal string of alphabetics. The second string is quoted to protect 'X' 
from the Shell. 012 is the ASCII code for newline. 

tr -cs A-Za-z AOir <filel >file2 

SEE ALSO 

ed(l), ascii(7), expand(l) 

BUGS ^ 

Won't handle ASCII NUL in stringl or stringl; always deletes NUL from input. V 



( 
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NAME 

touch - update date last modified of a file 

SYNOPSIS 

touch [-c][ -f]file... 

DESCRIPTION 

touch attempts to set the modified date of each file. If difile exists, this is done by reading a 
- character from the file and writing it back. If difile does not exist, an attempt will be made to 
create it unless the -c option is specified. The — f option will attempt to force the touch in 
spite of read and write permissions on a j^/e. 

SEE ALSO 

utimes(2) 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is 
understood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l) 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive 
file. 
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NAME 

uniq - report repeated lines in a file 

SYNOPSIS 

unjq [ — udc [ +n ] [ — n ] ] [ input [ output ] ] 

DESCRIPTION 

uniq reads the input file comparing adjacent lines. In the normal case, the second and 
succeeding copies of repeated Hnes are removed; the remainder is written on the output file. 
Note that repeated lines must be adjacent in order to be found; see sort (I), If the — u flag is 
used, just the lines that are not repeated in the original file are output. The -^d option 
specifies that one copy of just the repeated lines is to be written. The normal mode output is 
the union of the — u and —d mode outputs. 

The ^c option supersedes — u and -*-d and generates an output report in default style but with 
each line preceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

-/z The first n fields together with any blanks before each are ignored. A field is defined 

as a string of non-space, non-tab characters separated by tabs and spaces from its 
neighbors. 

+n The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

sort(l), comm(l) 
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NAME 1^ 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

units converts quantities expressed in various standard scales to their equivalents in other 
scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

^2,540006-^00 ' 

/ 3.93701e-01 

A quantity is specified as a multipUcative combination of units optionally preceded by a 
numeric multiplier. Powers are indicated by suffixed positive integers, division by the usual 
sign: 

You have: 15 pounds force/in2 
You want: atjn 

^lM069e'¥00 

/9J9730e-'01 

units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not 
Centigrade to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recog- 
nized, together with a generous leavening of exotica and a few constants of nature including: 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g 

mole Avogadro^'s number 

water pressure head per unit height of water 

au astronomical unit 

Tound' is a unit of mass. Compound names are run together, e.g. lightyear'. British units 
that differ from their US counterparts are prefixed thus: 'brgallon'. Currency is denoted 'belgi- 
umfranc', 'britainpound', ... 

For a complete list of units, 'cat /usr/lib/units'. 



FILES 
BUGS 



( 



/usr/lib/units 

Don't base your financial plans on the currency conversions. 



( 
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NAME 

w ~ who is on and what they are doing 

SYNOPSIS 

w [ — h ] [ ""S ] [ user ] 

DESCRIPTION 

W prints a summary of the current activity on the system, including what each user is doing. 
The heading Une shows the current time of day, how long the system has been up, the number 
of users logged into the system, and the load averages. The load average numbers give the 
number of jobs in the run queue averaged over 1, 5 and 15 minutes. 

The fields output are: the users login name, the name of the tty the user is on, the time of day 
the user logged on, the number of minutes since the user last typed anything, the CPU time 
used by all processes and their children on that terminal, the CPU time used by the currently 
active processes, the name and arguments of the current process. 

The — h flag suppresses the heading. The — s flag asks for a short form of output. In the 
short form, the tty is abbreviated, the login time and cpu times are left off, as are the argu- 
ments to commands. —1 gives the long output, which is the default. 

If a user name is included, the output will be restricted to that user. 

FILES 

/etc/utmp 

/dev/kmem 

/dev/drum 

SEE ALSO 

who(l), finger(l), ps(l) 

AUTHOR 

Mark Horton 

BUGS 

The notion of the "current process'' is muddy. The current algorithm is "the highest num- 
bered process on the terminal that is not ignoring interrupts, or, if there is none, the highest 
numbered process on the terminal''. This fails, for example, in critical sections of programs 
like the shell and editor, or when faulty programs running in the background fork and fail to 
ignore interrupts. (In cases where no process can be found, w prints "-".) 

The CPU time is only an estimate, in particular, if someone leaves a background process run- 
ning after logging out, the person currently on that terminal is "charged" with the time. 

Background processes are not shown, even though they account for much of the load on the 
system. 

Sometimes processes, typically those in the background, are printed with null or garbaged 
arguments. In these cases, the name of the command is printed in parentheses. 

W does not know about the new conventions for detection of background jobs. It will some- 
times find a background job instead of the right one. 
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NAME 

wall ~ write to all users 

SYNOPSIS 
wall 

DESCRIPTION 

wall reads its standard input until an end-otflle. It then sends this message, preceded by 
^Broadcast Message ../, to all logged in users. 

The sender should be super-user to override any protections the users may have invoked. 

FILES 

/dev/tty? 
/etc/utmp 

SEE ALSO 

mesg(l), write(l) 

DIAGNOSTICS 

*Cannot send to .,.' when the open on a user's tty file fails. 



( 
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NAME 

whatis - describe what a command is 

SYNOPSIS 

whatis command ... 

DESCRIPTION 

whatis looks up a given command and gives the header Une from the manual section. You can 
then -run the man(l) command to get more information. If the line starts 'name(section) ...' 
you can do *man section name' to get the documentation for it. Try 'whatis ed' and then you 
should do 'man 1 ed' to get the manual. 

whatis is actually just the — f option to the man(i) command. 

FILES 

/usr/man/whatis Database 

SEE ALSO 

man(l), catman(8) 
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NAME 

whereis - locate source, binary, and or manual for program 

SYNOPSIS 

whereis [ -sbm ] [ "-o ] [ -SBM dir ... -f ] name ... 

DESCRIPTION 

whereis locates source/binary and manuals sections for specified files. The supplied names are 
first stripped of leading pathname components and any (single) trailing extension of the form 
*\ext", e.g. '\c'\ Prefixes of ''s/' resulting from use of source code control are also dealt 
with, whereis then attempts to locate the desired program in a Ust of standard places. If any 
of the -bj -s or -m fl^s are given then whereis searches only for binaries, sources or manual 
sections respectively (or any two thereof). The -a flag may be used to search for unusual 
entries. A file is said to be unusual if it does not have one entry of each requested type. 
Thus "whereis -m -u *'' asks for those files in the current directory which have no documenta- 
tion. 

Finally, the -»B -M and -S flags may be used to change or otherwise limit the places where 
whereis searches. The -f file flags is used to terminate the last such directory list and signal 
the start of file names. 

EXAMPLE 

The foUowing finds all the files in /usr/bin which are not documented iii /usr/man/manl with 
source in /usr/src/cmd: 

cd /usr/ucb 

whereis -u -M /usr/man/manl -S /usr/src/cmd -f * 

FILES 

/usr/src/* 

/usr/{doc,man}/* 

/lib, /etc, /usr/{lib,bin,ucb,old,new,local} 

BUGS 

Since the program uses chdir(2) to run faster, pathnames given with the -M ™-S and -B must 
be full; i.e. they must begin with a '7". 



( 



( 
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NAME 

window - window environment 

SYNOPSIS 

window [ «t ] [ -f ] [ -d ] [ -e escape-char ] [ -c command ] [ -D ] [ -x ] 

DESCRIPTION 

window implements a window environment on ASCII terminals. 

A window is a rectangular portion of the physical terminal screen associated with a set of 
processes. Its size and position can be changed by the user at any time. Processes communi- 
cate with their window in the same way they normally interact with a terminal-through their 
standard input, output, and diagnostic file descriptors. The window program handles the 
details of redirecting input an output to and from the windows. At any one time, only one 
window can receive input from the keyboard, but all windows can simultaneously send output 
to the display. 

windows can overlap and are framed as necessary. Each window is named by one of the digits 
"1" to "9". This one character identifier, as well as a user definable label string, are displayed 
with the window on the top edge of its frame. A window can be designated to be in the fore- 
groundy in which case it will always be on top of all normal, non-foreground windows, and 
can be covered only by other foreground windows. A window need not be completely within 
the edges of the terminal screen. Thus a large window (possibly larger than the screen) may 
be positioned to show only a portion of its full size. 

Each window has a cursor and a set of control functions. Most intelligent terminal operations 
such as line and character deletion and insertion are supported. Display modes such as under- 
lining and reverse video are available if they are supported by the terminal. In addition, simi- 
lar to terminals with multiple pages of memory, each window has a text buffer which can have 
more lines than the window itself. 



OPTIONS 

When window starts up, the commands (see long commands below) contained in the file .win- 
dowrc in the user's home directory are executed. If it does not exist, two equal sized windows 
spanning the terminal screen are created by default. 

The command line options are 

— t Turn on terse mode (see terse command below). 

—f Fast. Don't perform any startup action. 

— d Ignore .windowrc and create the two default windows instead. 

— e escape-char 

Set the escape character to escape-char. Escape-char can be a single character, or in 
the form "X where X is any character, meaning control-X. 

— c command 

Execute the string command as a long command (see below) before doing anything 
else. 

—D Toggle debug mode. An odd number of -D options sets debug mode; an even number 
turns it off. 

-x Process start and stop characters (usually "S and "Q) locally, instead of passing them 
to the window for processing. This is especially useful on terminals that use '^S/^Q for 
handshaking. 

PROCESS ENVIRONMENT 

With each newly created window, a shell program is spawned with its process environment 
tailored to that window. Its standard input, output, and diagnostic file descriptors are bound 
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to one end of either a pseudo-terminal (piy (4)) or a UNIX domain socket {socketpair (4)). If I 

a pseudo-terminal is used, then its special characters and modes (see stty (1)) are copied from 
the physical terminal. A termcap (5) entry tailored to this window is created and passed as 
environment (environ (5)) variable TERMCAP. The termcap entry contains the window's size 
and characteristics as well as information from the physical terminal, such as the existence of 
underline, reverse video, and other display modes, and the codes produced by the terminal's 
function keys, if any. The environment variable WINDOWJfD is set to the current window 
number for use in prompts or other places. In addition, the window size attributes of 'the 
pseudo-terminal are set to reflect the size of this window, and updated whenever it is changed 
by the user. In particular, the editor vi (1) uses this information to redraw its display. 

OPERATION 

During normal execution, window can be in one of two states: conversation mode and com- 
mand mode. In conversation mode, the terminal's real cursor is placed at the cursor position 
of a particular window-called the current window~and input from the keyboard is sent to the 
process in that window. The current window is always on top of all other windows, except 
those in foreground. In addition, it is set apart by highlighting its identifier and label in 
reverse video. 

Typing window^ s escape character (normally "P) in conversation mode switches it into com- 
mand mode. In command mode, the top line of the terminal screen becomes the command 
prompt window, and window interprets input from the keyboard as commands to manipulate 
windows. 



There are two types of commands: short commands are usually one or two key strokes; long 
commands are strings either typed by the user in the command window (see the **:" command 
below), or read from a file (see source below). 

SHORT COMMANDS 

Below, # represents one of the digits "1" to "9" corresponding to the windows 1 to 9. "X 
means control-X, where X is any character. In particular, "" is control-". Escape is the escape 
key, or "/. 

# Select window # as the current window and return to conversation mode. 

%# Select window # but stay in command mode. 

Select the previous window and return to conversation mode. This is useful for tog- 
gling between two windows, 

escape Return to conversation mode. 

"P Return to conversation mode and write "P to the current window. Thus, typing two 

"P's in conversation mode sends one to the current window. If the window escape is 
changed to some other character, that character takes the place of "P here. 

? List a short summary of commands. 

"L Redraw the screen. 

q Exit window. Confirmation is requested. 

"Z Suspend window. 

w Create a new window. The user is prompted for the positions of the upper left and 

lower right comers of the window. The cursor is placed on the screen and the keys 
"h", **j", "k", and "1" move the cursor left, down, up, and right, respectively. The 
keys ''H", "J", "K", and "L" move the cursor to the respective limits of the screen. 
Typing a number before the movement keys repeats the movement that number of 
times. Return enters the cursor position as the upper left corner of the window. The 
lower right comer is entered in the same manner. During this process, the placement 
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of the new window is indicated by a rectangular box drawn on the screen, correspond- 
ing to where the new window will be framed. Typing escape at any point cancels this 
command. 

This window becomes the current window, and is given the first available ID. The 
default buffer size is used (see nline command below). 

Only fully visible windows can be created this way. 

c# Close window #. The process in the window is" sent the hangup signal (see kill (1)). 
Csh (1) should handle this signal correctly and cause no problems. 

m# Move window # to another location. A box in the shape of the window is drawn on 
the screen to indicate the new position of the window, and the same keys as those for 
the w command are used to position the box. The window can be moved partially 
off-screen. 

M# Move window # to its previous position. 

s# Change the size of window #. The user is prompted to enter the new lower right 
comer of the window. A box is drawn to indicate the new window size. The same 
keys used in w and m are used to enter the position. 

S# Change window # to its previous size. 

"Y Scroll the current window up by one line. 

"E Scroll the current window down by one line. 

"U Scroll the current window up by half the window size. 

"D Scroll the current window down by half the window size. 

"B Scroll the current window up by the full window size. 

"F Scroll the current window down by the full window size. 

h Move the cursor of the current window left by one column. 

j Move the cursor of the current window down by one line. 

k Move the cursor of the current window up by one line. 

1 Move the cursor of the current window right by one column. 

"S Stop output in the current window. 

"Q Start output in the current window. 

: Enter a line to be executed as long commands. Normal line editing characters (erase 

character, erase word, erase line) are supported. 

LONG COMMANDS 

Long commands are a sequence of statements parsed much like a programming language, with 
a syntax similar to that of C. Numeric and string expressions and variables are supported, as 
well as conditional statements. 

There are two data types: string and number. A string is a sequence of letters or digits begin- 
ning with a letter. "_" and ".'' are considered letters. Alternately, non-alphanumeric charac- 
ters can be included in strings by quoting them in """ or escaping them with "\". In addition, 
the "\" sequences of C are supported, both inside and outside quotes (e.g., "\n" is a new 
line, "\r" a carriage return). For example, these are legal strings: abcde01234, "&#$"*&#", 
ab"$#"cd, ab\$\#cd, 7usr/ucb/window". 

A number is an integer value in one of three forms: a decimal number, an octal number pre- 
ceded by "0", or a hexadecimal number preceded by "Ox" or "OX''. The natural machine 
integer size is used (i.e., the signed integer type of the C compiler). As in C, a non-zero 
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number represents a boolean true. 

The character *'#" begins a comment which terminates at the end of the line. 

A statement is either a conditional or an expression. Expression statements are terminated 
with a new line or ''f. To continue an expression on the next line, terminate the first line 
with *'V'. 

CONDnTONAL STATEMENT 

window has a single control structure: the fully bracketed if statement in the form 
if <expr> then 

<statement> 

elsif <expr> then 

<statement> 

else 

<statement> 

endif 
The else and elsif parts are optional, and the latter can be repeated any number of times. 
<£x/7r> must be numeric. 

EXPRESSIONS 

Expressions in window are similar to those in the C language, with most C operators sup- 
ported on numeric operands. In addition, some are overloaded to operate on strings. 

When an expression is used as a statement, its value is discarded after evaluation. Therefore, 

only expressions with side effects (assignments and function calls) are useful as statements. | 

Single valued (no arrays) variables are supported, of both numeric and string values. Some 
variables are predefined. They are listed below. 

The operators in order of increasing precedence: 

<exprl> ss <expr2> 

Assignment. The variable of name <exprl>, which must be string valued, is assigned 
the result of <expr2>. Returns the value of <expr2>, 

<exprl> ? <expr2> J <expr3> 

Returns the value of <expr2> if <exprl> evaluates true (non-zero numeric value); 
returns the value of <expr3> otherwise. Only one oi <expr2> ^nA <expr3> is 
evaluated. <Eji^/?ri> must be numeric. 

<exprl> II <expr2> 

Logical or. Numeric values only. Short circuit evaluation is supported (i.e., if 
<exprl> evaluates true, then <expr2> is not evaluated). 

<exprl> && <expr2> 

Logical and with short circuit evaluation. Numeric values only. 

<€xprl> I <expr2> 

Bitwise or. Numeric values only. 

<exprl> " <expr2> 

Bitwise exclusive or. Numeric values only. 

<exprl> & <expr2> 

Bitwise and. Numeric values only. . 

<exprl> ssss <expr2>, <€xprl> !^ <€xpr2> | 

Comparison (equal and not eqiial, respectively). The boolean result (either 1 or 0) of ^ 
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the comparison is returned. The operands can be numeric or string valued. One 
string operand forces the other to be converted to a string in necessary. 

<€xprl> < <expr2>, <exprl> > <expr2>, 

Less than, greater than, less than or equal to, greater than or equal to. Both numeric 
and string values, with automatic conversion as above. 

<exprl> << <expr2>, <exprl> >> <expr2> 

If both operands are numbers, <exprl> is bit shifted left (or right) by <expr2> bits. 
If <exprl> is a string, then its first (or last) <expr2> characters are returns (if 
<expr2> is also a string, then its length is used in place of its value). 

<exprl> + <expr2>, <exprl> - <expr2> 

Addition and subtraction on numbers. For "+", if one argument is a string, then the 
other is converted to a string, and the result is the concatenation of the two strings. 

<exprl> * <expr2>, <exprl> / <expr2>, 

Multiplication, division, modulo. Numbers only. 

-<expr>5 ~<expr>, !<expr>, $<expr>j $?<expr> 

The first three are unary minus, bitwise complement and logical complement on 
numbers only. The operator, "$", takes <expr> and returns the value of the variable 
of that name. If <expr> is numeric with value n and it appears within an aUas macro 
(see below), then it refers to the nth argument of the alias invocation. "$?" tests for 
the existence of the variable <expr>, and returns 1 if it exists or otherwise. 

<expr> (<arglist>) 

Function call. <Expr> must be a string that is the unique prefix of the name of a 
builtin window function or the full name of a user defined alias macro. In the case of 
a builtin function, <arglist> can be in one of two forms: 

<exprl>, <expr2>, ... 

argnamel = <exprl>, argname2 = <expr2>, . . . 
The two forms can in fact be intermixed, but the result is unpredictable. Most argu- 
ments can be omitted; default values will be suppUed for them. The argnames can be 
unique prefixes of the the argument names. The commas separating arguments are 
used only to disambiguate, and can usually be omitted. 

Only the first argument form is valid for user defined ahases. Aliases are defined using 
the alias builtin function (see below). Arguments are accessed via a variant of the 
variable mechanism (see "$" operator above). 

Most functions return value, but some are used for side effect only and so must be 
used as statements. When a function or an alias is used as a statement, the 
parenthesis surrounding the argument list may be omitted. Aliases return no value. 

BUILTIN FUNCTIONS 

The arguments are listed by name in their natural order. Optional arguments are in square 
brackets (**[ ]''). Arguments that have no names are in angle brackets ("<>"). 

alias([<strmg>], [< string -Ust>]) 

If no argument is given, all currently defined alias macros are listed. Otherwise, 
<string> is defined as an alias, with expansion <string-list> . The previous definition 
of <string>, if any, is returned. Default for <string-list> is no change. 

close (<window-list>) 

Close the windows specified in <window4ist> . If <window-list> is the word all, than 
all windows are closed. No value is returned. 

cursonnodes([modes]) 

Set the window cursor to modes. Modes is the bitwise or of the mode bits defined as 
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the variables m_ul (underline), m_rev (reverse video), mJ)lk (blinking), and m_grp 
(graphics, terminal dependent). Return value is the previous modes. Default is no 
change. For example, cursor($m_rev|$m_„blk) sets the window cursors to blinking 
reverse video. 

echo ([window] 9 [<string-list>]) 

Write the Hst of strings, <string4ist> , to window, separated by spaces and terminated 
with a new line. The strings are only displayed in the window, the processes in the 
window are not involved *(see write below). No value is returned. Default is the 
current window. 

escape ([escapee]) 

Set the escape character to escape-char. Returns the old escape character as a one 
character string. Default is no change. Escapee can be a string of a single character, 
or in the form "X, meaning control-X. 

foreground ([window], [flag]) 

Move window in or out of foreground. Flag can be one of on, off, yes, no, true, or 
false, with obvious meanings, or it can be a numeric expression, in which case a non- 
zero value is true. Returns the old foreground flag as a number. Default for window 
is the current window, default for flag is no change. 

label([window], [label]) 

Set the label of window to labeL Returns the old label as a string. Default for window 
is the current window, default for label is no change. To turn off a label, set it to an 
empty string (""). 

listO No arguments. List the identifiers and labels of all windows. No value is returned. 

nline([nllne]) 

Set the default buffer size to nline. Initially, it is 48 lines. Returns the old default 
buffer size. Default is no change. Using a very large buffer can slow the program 
down considerably. 

select ( [window] ) 

Make window the current window. The previous current window is returned. Default 
is no change. 

shell([<string"list>]) 

Set the default window shell program to <string-list> . Returns the first string in the 
old shell setting. Default is no change. Initially, the default shell is taken from the 
environment variable SHELL, 

source (filename) 

Read and execute the long commands in filename. Returns -1 if the file cannot be 
read, otherwise. 

terse ([flag]) 

Set terse mode to flag. In terse mode, the command window stays hidden even in 
command mode, and errors are reported by sounding the terminal's bell. Flag can 
take on the same values as in foreground above. Returns the old terse flag. Default is 
no change. 

unalias (alias) 

Undefine alias. Returns -1 if alias does not exist, otherwise. 

unset(yarlable) 

Undefine variable. Returns -1 if variable does not exist, otherwise. 

variables 

No arguments. List all variables. No value is returned. 



Page 6 February 6, 1989 MIPS Computer Systems, Inc, 



( 



( 



( 



WINDOW ( 1-BSD ) RISC/os Programmer's Reference WINDOW ( 1-BSD ) 



window([row]9 [column], [nrow], [ricol], [niine], [frame], 
[pty], [mapnl], [shell]) 

Open a window with upper left corner at row, column and size nrow, ncol. If nline is 
specified, then that many lines are allocated for the text buffer. Otherwise, the default 
buffer size is used. Default values for row, column, mow, and ncol are, respectively, 
the upper, left-most, lower, or right-most extremes of the screen. Frame, pty, and 
mapnl are flag values interpreted in the same way as the argument to foreground (see 
above); they mean, respectively, put a frame around this window (default true), allo- 
cate pseudo-terminal for this window rather than socketpair (default true), and map 
new line characters in this window to carriage return and line feed (default true if 
socketpair is used, false otherwise). Shell is a list of strings that will be used as the 
shell program to place in the window (default is the program specified by shell, see 
below). The created window's identifier is returned as a number. 

write ([window], [<string-list>]) 

Send the list of strings, <string'list> , to window, separated by spaces but not ter- 
minated with a new line. The strings are actually given to the window as input. No 
value is returned. Default is the current window. 

PREDEFINED VARIABLES 

These variables are for information only. Redefining them does not affect the internal opera- 
tion of window. 

baud The baud rate as a number between 50 and 38400. 

modes The display modes (reverse video, underline, blinking, graphics) supported by the phy- 
sical terminal. The value of modes is the bitwise or of some of the one bit values, 
mjblk, m_grp, m_rev, and mjul (see below). These values are useful in setting the 
window cursors' modes (see cursormodes above). 

m_blk The blinking mode bit. 

m_grp The graphics mode bit (not very useful). 

m_rev The reverse video mode bit. 

m_ul The underline mode bit. 

ncol The number of columns on the physical screen. 

nrow The number of rows on the physical screen. 

term The terminal type. The standard name, found in the second name field of the 
terminal's TERMCAP entry, is used. 



FILES 



V.windowrc startup command file. 

/dev/[pt]ty[pq]? pseudo-terminal devices. 



DIAGNOSTICS 

Should be self explanatory. 



BUGS 



When "insert line" is done in a window and line insert is supported by the physical terminal, 
line insertion will be used instead of screen redraw. In some cases, this can cause the screen 
to contain gaps, which are fixed when text is written into the gaps. 
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NAME V 

write ~ write to another user 

SYNOPSIS 

write user [ ttyname ] 

DESCRIPTION 

write copies lines from your terminal to that of another user. When first called, it sends the 
message 

Message from yourname@yoursystem on yourttyname at time... 

The recipient of the message should write back at this point. Communication continues until 
an end of file is read from the terminal or an interrupt is sent. At that point write writes 
*EOT' on the other terminal and exits, 

H you want to write to a user who is logged in more than once, the ttyname argument may be 
used to indicate the appropriate terminal name. 

Permission to write may be denied or granted by use of the mesg command. At the outset 
writing is allowed. Certain commands, in particular nroff and pr(l) disallow messages in order 
to prevent messy output. 

If the character '!' is found at the beginning of a line, write calls the shell to execute the rest of 
the line as a comniand. 

The following protocol is suggested for using write : when you first write to another user, wait 
for him to write back before starting to send. Each party should end each message with a dis- 
tinctive signal-(o) for *over' is conventional-that the other may reply, (oo) for 'over and out' 
is suggested when conversation is about to be terminated. g^ 

FILES V 

/etc/utmp to find user 

/bin/sh to execute M' 

SEE ALSO 

mesg(l), who(l), mail(l) 



( 
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NAME 

xsend, xget, enroll - secret mail 

SYNOPSIS 

xsend person 

xget 

enroll 

DESCRIPTION 

These commands implement a secure communication channel; it is like mail{l), but no one 
can read the messages except the intended recipient. The method embodies a public-key cryp- 
tosystem using knapsacks. 

To receive messages, use enroll; it asks you for a password that you must subsequently quote 
in order to receive secret mail. 

To receive secret mail, use xget. It asks for your password, then gives you the messages. 

To send secret mail, use xsend in the same manner as the ordinary mail command. (However, 
it will accept only one target). A message announcing the receipt of secret mail is also sent by 
ordinary mail. 

FILES 

/usr/spool/secretmail/*.key: keys 
/usr/spool/secretmail/*.[0-9] : messages 

SEE ALSO 

mail (1) 

BUGS 

It should be integrated with ordinary mail. The announcement of secret mail makes traffic 
analysis possible. 
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NAME 

yes - be repetitively affirmative 

SYNOPSIS 

yes [ expletive ] 

DESCRIPTION 

yes repeatedly outputs **y", or if expletive is given, that is output repeatedly. Termination is by 
rub out. 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



( 



( 



( 



ADVENTURE ( 6-BSD ) RISC/os Programmer's Reference ADVENTURE ( 6-BSD ) 



NAME 

adventure - an exploration game 

SYNOPSIS 

/usr/games/adventure 

DESCRIPTION 

The object of the game is to locate and explore Colossal Cave, find the treasures hidden 
there, and bring them back to the building with you. The program is self-descriptive to a 
point, but part of the game is to discover its rules. 

To terminate a game, type 'quit'; to save a game for later resumption, type 'suspend'. 

BUGS 

Saving a game creates a large executable file instead of just the information needed to resume 
the game. 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



ARITHMETIC ( 6-BSD ) RISC/os Programmer's Reference ARITHMETIC ( 6-BSD ) 

NAME \ / 

arithmetic - provide drill in number facts 

SYNOPSIS 

/usr/games/arithmetic [ +— x/ ] [ range ] 

DESCRIPTION 

arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the 
answer is correct, it types back *'Right!'^ and a new problem. If the answer is wrongs it 
replies *'What?'^ and waits for another answer. After every twenty problems, it publishes 
statistics on correctness and the time required to answer. 

To quit the program, type an interrupt (delete). 

The first optional argument determines the kind of problem to be generated; +— x/ respec- 
tively cause addition, subtraction, multiplication, and division problems to be generated. One 
or more characters can be given; if more than one is given, the different types of problems 
will be mixed in random order; default is +— • 

Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and 
quotients will be less than or equal to the value of range. Default range is 10. 

At the start, all numbers less than or equal to range are equally likely to appear. If the 
respondent makes a mistake, the numbers in the problem which was missed become more 
likely to reappear. 

As a matter of educational philosophy, the program will not give correct answers, since the 
learner should, in principle, be able to calculate them. Thus the program is intended to pro- 
vide drill for someone just past the first learning stage, not to teach number facts de novo. 
For almost all users, the relevant statistic should be time per problem, not percent correct. 



( 
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NAME 

backgammon - the game 

SYNOPSIS 

/usr/games/backgammon [ -f ] [ -n ] [ «b ] [ -r ] [ -w ] [ -p[brw] ] [ --titerm] ] [ -s\file] ] [ 

filename ] 

DESCRIPTION 

This program plays the game of backgammon in a full-screen mode. Instructions are provided 

by the game itself. If no filename is given (either with the -s option or separately), a new 

game is started. Otherwise, the file is taken to be a file into which a previous game has been 

saved. 

The environment variable BACKGAMMON is read for options. All options except for -s, 

-p, and -s may be given in the variable. Unknown characters (including dashes and whi- 

tespace) are silently ignored. 

OPTIONS 

-f Fast mode. Do not pause to print message about being able to move. This makes the 
screen a little jumpy at (hopefully rare) times, but is often preferable to the three-second 
wait done normally. 

-^n Don't ask if rules or instructions are needed. 

«-b User will play both red and white. 

-r User will play red. 

— w User will play white. 

— p[brw] 

Print board after given player moves. By default, the board is printed upon request. This 
option is ignored in full-screen mode. 

Use the given terminal type. If none is given, '*su'' (standard unknown terminal) is used. 

— s[/z/e] 

Recover saved game from the named file. If no filename is given, this option is ignored. 
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NAME 

banner - print large banner on printer 

SYNOPSIS 

/esr/games/banner [ — w;^ ] message ... 

DESCRIPTION 

banner prints a large, high quality banner on the standard output. If the message is omitted, it 
prompts for and reads one line of its standard input. If -w is given, the output is scrunched 
down from a width of 132 to n , suitable for a narrow terminal. If n is omitted, it defaults to 
80. 

The output should be printed on a hard-copy device, up to 132 columns wide, with no breaks 
between the pages. The volume is great enough that you may want a printer or a fast hardcopy 
terminal, but if you are patient, a decwriter or other 300 baud terminal will do. 



( 



BUGS 



Several ASCII characters are not defined, notably <,>,[, ], \, ", _, {, }, |, and ~. Also, the 
characters ", ', and & are funny looking (but in a useful way.) 

The »-w option is implemented by skipping some rows and columns. The smaller it gets, the 
grainier the output. Sometimes it runs letters together. 



AUTHOR 

Mark Horton 



( 



( 
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NAME 

battlestar - a tropical adventure game 

SYNOPSIS 

battlestar [ -r (recover a saved game) ] 

DESCRIPTION 

battlestar is an adventure game in the classic style. However, It's slightly less of a puzzle and 
more a game of exploration. There are a few magical words in the game, but on the whole, 
simple EngUsh should suffice to make one's desires understandable to the parser. 

THE SETTING 

In the days before the darkness came, when battlestars ruled the heavens... 

Three He made and gave them to His daughters, 
Beautiful nymphs, the goddesses of the waters. 
One to bring good luck and simple feats of wonder, 
Two to wash the lands and churn the waves asunder, 
Three to rule the world and purge the skies with thunder. 

In those times great wizards were known and their powers were beyond belief. They could 
take any object from thin air, and, uttering the word 

In those times men were known for their lust of gold and desire to wear iBne weapons. 
Swords and coats of mail were fashioned that could withstand a laser blast. 

But when the darkness fell, the rightful reigns were toppled. Swords and helms and heads of 
state went rolling across the grass. The entire fleet of battlestars was reduced to a single ship. 

SAMPLE COMMANDS 

take — take an object 

drop — drop an object 

wear — wear an object you are holding 

draw — carry an object you are wearing 

puton — - take an object and wear it 

take off - draw an object and drop it 

throw <object> <direction> 

! < shell esc> 

IMPLIED OBJECTS 

>-: take watermellon 

watermellon: 

Taken. 

>-: eat 

watermellon: 

Eaten. 

>-: take knife and sword and apple, drop all 

knife: 

Taken. 

broadsword: 

Taken. 
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apple: |^ 

Taken. 

knife: 

Dropped. 

broadsword: 

Dropped. 

apple: 

Dropped. 

>-:get 

knife: 

Taken. 

Notice that the "shadow" of the next word stays around if you want to take advantage of it. 
That is, saying "take knife" and then "drop" will drop the knife you just took. 

SCORE &INVEN 

The two commands "score" and "inven" will print out your current status in the game. 

SAVING A GAME 

The command "save" will save your game in a file called "Bstar." You can recover a saved 
game by using the "-r" option when you start up the game. 

DIRECTIONS 

The compass directions N, S, E, and W can be used if you have a compass. If you don't 
have a compass, you'll have to say R, L, A, or B, which stand for Right, Left, Ahead, and 
Back. Directions printed in room descriptions are always printed in R, L, A, & B relative 
directions. £ 

HISTORY V 

I wrote battlestar in 1979 in order to experiment with the niceties of the C Language. Most 
interesting things that happen in the game are hardwired into the code, so don't send me any 
hate mail about it! Instead, enjoy art for art's sake! 

AUTHOR 

David Riggle 

INSPIRATION & ASSISTANCE 

Chris Guthrie 

Peter Da Silva 

Kevin Brown 

Edward Wang 

Ken Arnold & Company 

BUGS 

Countless, 

FAN MAIL 

Send to edward%ucbarpa@Berkeley.arpa, chris%ucbcory@berkeley,arpa^ 

riggle . pa@xerox . arpa . 



( 
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NAME 

bed - convert to antique media 

SYNOPSIS 

/usr/games/bcd text 

DESCRIPTION 

bed converts the literal text into a form familiar to old-timers. 

SEE ALSO 

dd(l) 



MIPS Computer Systems, Inc. February 6, 1989 Page 1 



BOGGLE ( 6-BSD ) RISC/os Programmer's Reference BOGGLE ( 6-BSD ) 



( 



NAME 

boggle - play the game of boggle 

SYNOPSIS 

/usr/gam«i$/boggle [ + ][++] 

DESCRIPTION 

This program is intended for people wishing to sharpen their skills at Boggle (TM Parker 
Bros.). If you invoke the program with 4 arguments of 4 letters each, (e.g. "boggk appi epie 
moth erhd'O the program forms the obvious Boggle grid and Usts all the words from 
/usr/dict/words found therein. If you invoke the program without arguments, it will generate a 
board for you, let you enter words for 3 minutes, and then tell you how well you did relative 
to /usr/dict/words. 

The object of Boggle is to find, within 3 minutes, as many words as possible in a 4 by 4 grid of 
letters. Words may be formed from any sequence of 3 or more adjacent letters in the grid. 
The letters may join horizontally, vertically, or diagonally. However, no position in the grid 
may be used more than once within any one word. In competitive play amongst humans, each 
player is given credit for those of his words which no other player has found. 

In interactive play, enter your words separated by spaces, tabs, or newlines. A bell will ring 
when there is 2:00, 1:00, 0:10, 0:02, 0:01, and 0:00 time left. You may complete any word 
started before the expiration of time. You can surrender before time is up by hitting 'break'. 
While entering words, your erase character is only effective within the current word and your 
line kill character is ignored. 

Advanced players may wish to invoke the program with 1 or 2 +'s as the first argument. The 

first + removes the restriction that positions can only be used once in each word. The second ^ 

+ causes a position to be considered adjacent to itself as well as its (up to) 8 neighbors. | 



( 
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NAME 

canfield, cfscores - the solitaire card game canfield 

SYNOPSIS 

/usr/games/canfield [ ^^a ] [ — b ] [ -"C ] [ — n ] [ ""X ] 
/usr/games/cf scores [ —a ] 

DESCRIPTION 

If you have never played solitaire before, it is recommended that you consult a solitaire 
instruction book. In Canfield, tableau cards may be built on each other downward in alternate 
colors. An entire pile must be moved as a unit in building. Top cards of the piles are available 
to be played on foundations, but never into empty spaces. 

Spaces must be filled from the stock. The top card of the stock also is available to be played 
on foundations or built on tableau piles. After the stock is exhausted, tableau spaces may be 
filled from the talon and the player may keep them open until he wishes to use them. 

Cards are dealt from the hand to the talon by threes and this repeats until there are no more 
cards in the hand or the player quits. To have cards dealt onto the talon the player types 'ht' 
for his move. Foundation base cards are also automatically moved to the foundation when 
they become available. 

The command 'c' causes canfield to maintain card counting statistics on the bottom of the 
screen. When properly used this can greatly increase one's chances of winning. 

The rules for betting are somewhat less strict than those used in the official version of the 
game. The initial deal costs $13. You may quit at this point or inspect the game. Inspection 
costs $13 and allows you to make as many moves as possible without moving any cards from 
your hand to the talon. (The initial deal places three cards on the talon; if all these cards are 
used, three more are made available.) Finally, if the game seems interesting, you must pay the 
final installment of $26. At this point you are credited at the rate of $5 for each card on the 
foundation; as the game progresses you are credited with $5 for each card that is moved to the 
foundation. Each run through the hand after the first costs $5. The card counting feature 
costs $1 for each unknown card that is identified. If the information is toggled on, you are 
only charged for cards that became visible since it was last turned on. Thus the maximum 
cost of information is $34, Playing time is charged at a rate of $1 per minute. 

Normally, input must followed by a newline. In abbreviated mode, input is read until the 
command is known. In some cases this is one character, and in other cases it is two charac- 
ters. It is a good idea to use the standard input mode until you understand all of the com- 
mands, since playing too fast can lose the game. 

The environment variable CANFIELD is read before processing the command-line options. 
The processing of this data is naive. If any of the known option characters are found, those 
options are set, and all other characters are silently ignored. 

With no arguments, the program cfscores prints out the current status of your canfield 
account. If a user name is specified, it prints out the status of their canfield account. 

OPTIONS 

—a In canfield, the —a option says to turn on abbreviated mode (see above). In cfscores, 
this option says to print scores for all players. 

— b Start with the betting box. The default is to start with the instruction box. 

— c Turn on card counting. 

—n No asking if instructions are desired. 

—X Start with no box. 
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FH.ES \ 

/usr/games/caHfield the game itself 
/usr/games/cf scores the database prtater 
/usr/games/Iib/cf scores the database of scores 

BUGS 

It is impossible to cheat. 

AUTHORS 

Originally written: Steve L^vitue 

Further random hacking by: Steve Fddman, Kirk McKusicjc, Mik^y Ol^on, and Eric AHman. 



( 
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NAME 

cribbage - the card game cribbage 

SYNOPSIS 

/usr/games/cribbage [ — req ] name ... 

DESCRIPTION 

cribbage plays the card game cribbage, with the program playing one hand and the user the 
other. The program will initially ask the user if the rules of the game are needed - if so, it 
will print out the appropriate section from According to Hoyle with more (I). 

cribbage options include: 

— e When the player makes a mistake scoring his hand or crib, provide an explanation of 
the correct score. (This is especially useful for beginning players.) 

— q Print a shorter form of all messages - this is only recommended for users who have 
played the game without specifying this option. 

— r Instead of asking the player to cut the deck, the program will randomly cut the deck. 

cribbage first asks the player whether he wishes to play a short game (*'once around", to 61) or 
a long game ("twice around", to 121). A response of 's' will result in a short game, any other 
response will play a long game. 

At the start of the first game, the program asks the player to cut the deck to determine who 
gets the first crib. The user should respond with a number between and 51, indicating how 
many cards down the deck is to be cut. The player who cuts the lower ranked card gets the 
first crib. If more than one game is played, the loser of the previous game gets the first crib in 
the current game. 

For each hand, the program first prints the player's hand, whose crib it is, and then asks the 
player to discard two cards into the crib. The cards are prompted for one per line, and are 
typed as explained below. 

After discarding, the program cuts the deck (if it is the player's crib) or asks the player to cut 
the deck (if it's its crib); in the latter case, the appropriate response is a number from to 39 
indicating how far down the remaining 40 cards are to be cut. 

After cutting the deck, play starts with the non-dealer (the person who doesn't have the crib) 
leading the first card. Play continues, as per cribbage, until all cards are exhausted. The pro- 
gram keeps track of the scoring of all points and the total of the cards on the table. 

After play, the hands are scored. The program requests the player to score his hand (and the 
crib, if it is his) by printing out the appropriate cards (and the cut card enclosed in brackets). 
Play continues until one player reaches the game limit (61 or 121). 

A carriage return when a numeric input is expected is equivalent to typing the lowest legal 
value; when cutting the deck this is equivalent to choosing the top card. 

Cards are specified as rank followed by suit. The ranks may be specified as one of: 'a', '2', 
'3', %\ '5\ %\ 7', *8', *9', 't', 7, 'q', and *k', or alternatively, one of: "ace", "two", "three", 
"four", "five", "six", "seven", "eight", "nine", "ten", "jack", "queen", and "king". Suits 
may be specified as: *s', 'h', *d', and 'c', or alternatively as: "spades", "hearts", "diamonds", 
and "clubs". A card may be specified as: <rank> " " <suit>, or: <rank> " of " <suit>. 
If the single letter rank and suit designations are used, the space separating the suit and rank 
may be left out. Also, if only one card of the desired rank is playable, typing the rank is 
sufficient. For example, if your hand was "2H, 4D, 5C, 6H, JC, KD" and it was desired to 
discard the king of diamonds, any of the following could be typed: "k", "king", "kd", "k d", 
"k of d", "king d", "king of d", "k diamonds", "k of diamonds", "king diamonds", or "king 
of diamonds". 
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FILES ^ 

/usr/games/cribbage 

AUTHORS 

Earl T. Cohen wrote the logic. Ken Arnold added the screen oriented interface. 



( 
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NAME 

fish - play ''Go fish'' 

SYNOPSIS 

/usr/games/ilsh 

DESCRIPTION 

fish plays the game of "Go fish", a childrens' card gipiime. The Object is to accumulate 'books' 
of 4 cards with the same face value. The players alternate turns; each turn begms with one 
player selecting a card from his hand, and asking the other player for all cards of that face 
value. If the other player has one or more cards of that face value in his hand, he gives them 
to the first player, and the first player makes another request. Eventually, the first player asks 
for a card which is not in the second player's hand: he replies *GO FISH!' The first player 
then draws a card from the 'pool' of undealt cards. If this is the card he had last requested, 
he draws again, When a book is made, either through drawing or requesting, the cards are 
laid down and no further action takes place with that face value. 

To play the computer, simply make guesses by typing a, 2, 3, 4, 5, 6, 7, 8, 9, 10, j, q, or k 
when asked. Hitting return gives you information about the size of iny hand and the pool, 
and tells you about my books. Saying 'p' as a first guess puts you into 'pro' level; The default 
is pretty dumb. 
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NAME 

fortune - print a random, hopefully interesting, adage 

SYNOPSIS 

/usr/games/fortune [ "^ ] [ -^wslj^od ] [file ] 

DESCRIPTION 

/onwne with no argunieuts prints out a random adage. The flags mean; 

-w Waits before termination for an amount of time calculated from the number of charac- 
ters in the message, This is useful if it is executed as part of the logout procedure to 
guarantee that the message cau be read before the screen is cleared. 

— s Short messages only* 

-^1 Long messages only. 

—o Choose from an alternate list of adages, often used for potentially offensive ones. 

■^a Choose from either list of adages. 

-d Dump the table information. This gives information about which file was read, the sizes 
of the adages, the internal state, and the file that was written (see below). 

In order to canse fortune to be random, the program must store a table in a file. By default, 
this information is stored in the data file, but this can cause the data, file to be backed up all 
of the time. In order to defeat this, if the file /u$r/ games/lib /fortunes Jbl exists and is owned 
by daemon, it is used as the table file. If the file is empty, the table is read from the standard 
file, but the table will be written to the alternate file. The result is that there is a 28-byte file 
that gets backed up instead of a 4(X)Kbyte file. 

The user may specify a file of adages. This file must be created by the program $trfile, which / 

is only available with the fortune source, and be given by the user as jfJ/e. Only one such file V 

may be named, subsequent ones are ignored, In addition, this defeats the use of the alternate 
table file. 



FILES 



lusr/ games/lib /fortunes, dat 
Data file 

/usr/games/lib/fortunes, tbl 
Alternate table file 



AUTHOR 

Ken Arnold 



( 
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NAME 

hangman - Computer version of the game hangman 

SYNOPSIS 

/u sr/game s/hangman 

DESCRIPTION 

In hangman, the computer picks a word from the on-line word list and you must try to guess 
it. The computer keeps track of which letters have been guessed and how many wrong 
guesses you have made on the screen in a graphic fashion. 

FILES 

/usr/dict/words On-line word Hst 

AUTHOR 

Ken Arnold 
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NAME 

hunt - a multi-player multi-terminal game 

SYNOPSIS 

/osr/games/hunt [-q] [-m] [hostname] [-1 name] 

DESCRIPTION 

The object of the game hunt is to kill off the other players. There are no rooms, no treasures, 
and no monsters. Instead, you wander around a maze, find grenades, trip mines, and shoot 
down walls and players. The more players you kill before you die, the better your score is. If 
the --m fl^ is given, you enter the game as a monitor (you can see the action but you cannot 
play). 

hunt normally looks for an active game on the local network; if none is found, it starts one up 
on the local host. One may specify the location of the game by giving the hostname argument. 
The player name may be specified on the command line by using the -I option. This com- 
mand syntax was chosen for rlogin/rsh compatibility. If the -q flag is given, hunt queries the 
network and reports if an active game were found. This is useful for .login scripts. 

hunt only works on crt (vdt) terminals with at least 24 lines, 80 columns, and cursor address- 
ing. The screen is divided in to 3 areas. On the right hand side is the status area. It shows 
you how much damage youVe sustained, how many charges you have left, who's in the game, 
who's scanning (the asterisk in front of the name), who's cloaked (the plus sign in front of the 
name), and other players' scores. Most of the rest of the screen is taken up by your map of 
the maze, except for the 24th line, which is used for longer messages that don't fit in the status 
area. 

hunt uses the same keys to move as vi does, i.e. , li,j,k, and 1 for left, down, up, right respec- 
tively. To change which direction you're facing in the maze, use the upper case version of the 
movement key (/.6. , HJKL). 

Other commands are: 

f - Fire (in the direction you're facing) (Takes 1 charge) 

g - Throw grenade (in the direction you're facing) (Takes 9 charges) 

F - Throw satchel charge (Takes 25 charges) 

G - Throw bomb (Takes 49 charges) 

o - Throw small slime bomb (Takes 15 charges) 

O - Throw big slime bomb (Takes 30 charges) 

s - Scan (show where other players are) (Takes 1 charge) 

c - Cloak (hide from scanners) (Takes 1 charge) 

"L - Redraw screen 

q ~ Quit 

Knowing what the symbols on the screen often helps: 



-1+ 


- walls 


/\ 


~ diagonal (deflecting) walls 


# 


- doors (dispersion walls) 


5 


- small mine 


g 


~ large mine 


: 


- shot 


o 


- grenade 


O 


- satchel charge 


@ 


- bomb 


s 


~ small slime bomb 



( 



( 
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$ - big slime bomb 

> < " V - you facing right, left, up, or down 

} { i ! - other players facing right, left, up, or down 

* - explosion 

\|/ 

-*- - grenade and large mine explosion 

/|\ 

Satchel and bomb explosions are larger than grenades (5x5, 7x7, 
and 3x3 respectively). 

Other helpful hints: 

• You can only fire in the direction you are facing. 

• You can only fire three shots in a row, then the gun must cool. 

• A shot only affects the square it hits. 

• Shots and grenades move 5 times faster than you do. 

• To stab someone, you must face that player and move at them. 

• Stabbing does 2 points worth of damage and shooting does 5 points. 

• Slime does 5 points of dams^e each time it hits. 

• You start with 15 charges and get 5 more for every new player. 

• A grenade affects the nine squares centered about the square it hits. 

» A satchel affects the twenty-five squares centered about the square it hits. 

• A bomb affects the forty-nine squares centered about the square it hits. 

• Slime affects all squares it oozes over (15 or 30 respectively). 

• One small mine and one large mine is placed in the maze for every new player. A mine has 
a 5% probability of tripping when you walk directly at it; 50% when going- sideways on to it; 
95% when backing up on to it. Tripping a mine costs you 5 points or 10 points respec- 
tively. Defusing a mine is worth 1 charge or 9 charges respectively. 

• You cannot see behind you. 

• Scanning lasts for (20 times the number of players) turns. Scanning takes 1 ammo charge, 
so don't waste all your charges scanning. 

» Cloaking lasts for 20 turns. 

• Whenever you kill someone, you get 2 more damage capacity points and 2 damage points 
taken away. 

• Maximum typeahead is 5 characters. 

• A shot destroys normal (i.e., non-di^onal, non-door) walls. 

• Diagonal walls deflect shots and change orientation. 

• Doors disperse shots in random directions (up, down, left, right). 

• Diagonal walls and doors cannot be destroyed by direct shots but may be destroyed by an 
adjacent grenade explosion. 

• Slime goes around walls, not through them. 

• Walls regenerate, reappearing in the order they were destroyed. One percent of the regen- 
erated walls will be diagonal walls or doors. When a wall is generated directly beneath a 
player, he is thrown in a random direction for a random period of time. When he lands, he 
sustains damage (up to 20 percent of the amount of damage he had before impact); that is, 
the less damage he had, the more nimble he is and therejfore less likely to hurt himself on 
landing. 



The environment variable HUNT is checked to get the player name, it you don't have this 
variable set, hunt will ask you what name you want to play under. K it is set, you may also 
set up a single character keyboard map, but then you have to enumerate the options: 
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e.g. setenv HUNT ''*name-Sneaky,mapkey=z;oFfGglf2g3F4G" 
sets the player name to Sneaky, and the maps z to o, F to f, G to g, 1 to f, 2 to g, 3 to F, 
and 4 to G. The mapkey option must be last. 
• It's a boring game if you're the only one playing. 

Your score is the ratio of number of kills to number of times you entered the game and is only 
kept for the duration of a single session of hunt. 

hunt normally drives up the load average to be about (number_of_players -f- 0.5) greater than it 
would be without a hunt game executing. A limit of three players per host and nine players 
total is enforced by hunt. 



FILES 



/usr/games/lib/hunt. driver game coordinator 

AUTHORS 

Conrad Huang, Ken Arnold, and Greg Couch; University of California, San Francisco, Com- 
puter Graphics Lab 

ACKNOWLEDGEMENTS 

We thank Don Kneller, John Thomason, Eric Pettersen, and Scott Weiner for providing end- 
less hours of play-testing to improve the character of the game. We hope their significant oth- 
ers will forgive them; we certainly don't. 

BUGS 

To keep up the pace, not everything is as realistic as possible. 

There were some bugs in early releases of 4,2 BSD that hunt helped discover; hunt will crash 
your system if those bugs haven't been fixed. 



( 



( 



MIPS Computer Systems, Inc. February 9, 1989 Page 3 



MILLE ( 6-BSD ) RISC/os Programmer's Reference MILLE ( 6-BSD ) 



NAME 

mille - play mille Bournes 

SYNOPSIS 

/usr/games/miUe [ file ] 

DESCRIPTION 

mille plays a two-handed game reminiscent of the Parker Brother's game of mille Bournes with 

you. The rules are described below. If a file name is given on the command line, the game 

saved in tfiat file is started. 

When a game is started up, the bottom of the score window will contain a Ust of commands. 

They are: 

P Pick a card from the deck. This card is placed in the T' slot in your hand. 

D Discard a card from your hand. To indicate which card, type the number of the card 

in the hand (or 'T'' for the just-picked card) followed by a <RETURN> or 
<SPACE>. The <RETURN or <SPACE> is required to allow recovery from typos 
which can be very expensive, like discarding safeties. 

U Use a card. The card is again indicated by its number, followed by a <RETURN> or 

<SPACE>. 
O Toggle ordering the hand. By default off, if turned on it will sort the cards in your 

hand appropriately. This is not recommended for the impatient on slow terminals. 

Q Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> 

(or <RUBOUT>) is equivalent. 

S Save the game in a file. If the game was started from a file, you will be given an 

opportunity to save it on the same file. If you don't wish to, or you did not start from 
a file, you will be asked for the file name. If you type a <RETURN> without a 
name, the save will be terminated and the game resumed, 

R Redraw the screen from scratch. The command ''L (control 'V) will also work. 

W Toggle window type. This switches the score window between the startup window 

(with all the command names) and the end-of-game window. Using the end-of-game 
window saves time by eliminating the switch at the end of the game to show the final 
score. Recommended for hackers and other miscreants. 

If you make a mistake, an error message will be printed on the last Une of the score window, 
and a bell will beep. 

At the end of each hand or game, you will be asked if you wish to play another. If not, it will 
ask you if you want to save the game. If you do, and the save is unsuccessful, play will be 
resumed as if you had said you wanted to play another hand/game. This allows you to use the 
"S'' command to reattempt the save. 

AUTHOR 

Ken Arnold 

(The game itself is a product of Parker Brothers, Inc.) 

SEE ALSO 

curses (3X), Screen Updating and Cursor Movement Optimization: A Library Package, Ken 
Arnold 

CARDS 

Here is some useful information. The number in parentheses after the card name is the 
number of that card in the deck: 
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Hazard 

Out of Gas (2) 
Flat Tire (2) 
Accident (2) 
Stop (4) 
Speed Limit (3) 



Repair 

Gasoline (6) 
Spare Tire (6) 
Repairs (6) 
Go (14) 
End of Limit (6) 



Safety 

Extra Tank (1) 
Puncture Proof (1) 
Driving Ace (1) 
Right of Way (1) 



( 



25 - (10), 50 ■- (10), 75 - (10); 100 - (12), 200 - (4) 



RULES 



Object: The point of this game is to get a total of 5000 points in several hands. Each hand is 
a race to put down exactly 700 miles before your opponent does. Beyond the points gained by 
putting down milestones, there are several other ways of making points. 

Overview: The game is played with a deck of 101 cards. Distance cards represent a number of 
miles traveled. They come in denominations of 25, 50, 75, 100, and 200. When one is 
played, it adds that many miles to the player's trip so far this hand. Hazard cards are used to 
prevent your opponent from putting down Distance cards. They can only be played if your 
opponent has a Go card on top of the Battle pile. The cards are Out of Gas, Accident, Rat 
Tire, Speed Limit, and Stop, Remedy cards fix problems caused by Hazard cards played on 
you by your opponent. The cards are Gasoline , Repairs , Spare Tire , End of Limit, and Go, 
Safety cards prevent your opponent from putting specific Hazard cards on you in the first 
place. They are Extra Tank, Driving Ace, Puncture Proof , and Right of Way, and there are 
only one of each in the deck. 

Board Layout: The board is split into several areas. From top to bottom, they are: SAFETY 
AREA (unlabeled): This is where the safeties will be placed as they are played. HAND: These 
are the cards in your hand. BATTLE: This is the Battle pile. All the Hazard and Remedy 
Cards are played here, except the Speed Limit and End of Limit cards. Only the top card is 
displayed, as it is the only effective one. SPEED: The Speed pile. The Speed Limit and End 
of Limit cards are played here to control the speed at which the player is allowed to put down 
miles. MILEAGE: Miles are placed here. The total of the numbers shown here is the dis- 
tance traveled so far. 

Play: The first pick alternates between the two players. Each turn usually starts with a pick 
from the deck. The player then plays a card, or if this is not possible or desirable, discards 
one. Normally, a play or discard of a single card constitutes a turn. If the card played is a 
safety, however, the same player takes another turn immediately. 

This repeats until one of the players reaches 700 points or the deck runs out. If someone 
reaches 700, they have the option of going for an Extension, which means that the play contin- 
ues until someone reaches 1000 miles. 

Ha^iard and Remedy Cards: Hazard Cards are played on your opponent's Battle and Speed 
piles. Remedy Cards are used for undoing the effects of your opponent's nastiness. 

Go (Green Light) must be the top card on your Battle pile for you to play any mileage, 
unless you have played the Right of Way card (see below). 

Stop is played on your opponent's Go card to prevent them from playing mileage until they 
play a Go card. 

Speed Limit is played on your opponent's Speed pile. Until they play an End of Limit they 
can only play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit is played on your Speed pile to nullify a Speed Limit played by your 
opponent. 

Out of Gas is played on your opponent's Go card. They must then play a Gasoline card, 
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and then a Go card before they can play any more mileage. 

Flat Tire is played on your opponent's Go card. They must then play a Spare Tire card, 
and then a Go card before they can play any more mileage. 

Accident is played on your opponent's Go card. They must then play a Repairs card, and 
then a Go card before they can play any more mileage. 

Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard 
cards on you for the rest of the hand. It cancels an attack in progress, and always entitles the 
player to an extra turn . 

Right of Way prevents your opjponent from playing both Stop and Speed Limit cards on 
you. It also acts as a permanent Go card for the rest of the hand, so you can play mileage as 
long as there is not a Hazard card on top of your Battle pile. In this case only, your opponent 
can play Hazard cards directly on a Remedy card other than a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 

Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a 
Right of Way in your Safety area and are not stopped by a Hazard Card. They can be played 
in any combination that totals exactly 700 miles, except that you cannot play more than two 
200 mile cards in one hand. A hand ends whenever one player gets exactly 700 miles or the 
deck runs out. In that case, play continues until neither someone reaches 700, or neither 
player can use any cards in their hand. If the trip is completed after the deck runs out, this is 
called Delayed Action . 

Coup Fourre: This is a French fencing term for a counter-thrust move as part of a parry to an 
opponents attack. In mille Bournes, it is used as follows: If an opponent plays a Hazard card, 
and you have the corresponding Safety in your hand, you play it immediately, even before you 
draw. This immediately removes the Hazard card from your Battle pile, and protects you 
from that card for the rest of the game. This gives you more points (see '^Scoring" below). 

Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the 
trip. The terms used in the Score window have the following meanings: 

MOestones Played: Each player scores as many miles as they played before the trip ended. 

Each Safety: 100 points for each safety in the Safety area. 

All 4 Safeties: 300 points if all four safeties are played. 

Each Coup Foure: 300 points for each Coup Foure accomplished. 

The following bonus scores can apply only to the winning player. 

Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 

Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 

Delayed Action: 300 points bonus for finishing after the deck was exhausted. 

Extension: 200 points bonus for completing a 1000 mile trip. 

Shut-Out: 500 points bonus for completing the trip before your opponent played any 
mileage cards. 

Running totals are also kept for the current score for each player for the hand (Hand Total), 
the game (Overall Total), and number of games won (Games). 
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NAME 

monop " monopoly game 

SYNOPSIS 

/usr/games/monop [ file ] 

DESCRIPTION 

monop is reminiscent of the Parker Brother's game monopoly, and monitors a game between 1 
to 9 users. It is assumed that- the rules of monopoly are known. The game follows the stan- 
dard rules, with the exception that, if a property goes up for auction and there are only two 
solvent players, no auction is held and the property remains unowned. 

The game, in effect, lends the player money, so it is possible to buy something which you can- 
not afford. However, as soon as a person goes into debt, he must ''fix the problem'', i.e. , 
make himself solvent, before play can continue. If this is not possible, the player's property 
reverts to his debtee, either a player or the bank. A player can resign at any time to any per- 
son or the bank, which puts the property back on the board, unowned. 

Any time that the response to a question is 2i string, e.g., a name, place or person, you can 
type '?' to get a fist of valid answers. It is not possible to input a negative number, nor is it 
ever necessary. 

A Summary of Commands: 

quit: quit game: This allows you to quit the game. It asks you if you're sure. 

print: print board: This prints out the current board. The columns have the following 
meanings (column headings are the same for the where, own holdings, and hold- 
ings commands): 

Name The first ten characters of the name of the square 

Own The number of the owner of the property. 

Price The cost of the property (if any) 

Mg This field has a '*' in it if the property is mortgaged 

# If the property is a Utility or Railroad, this is the number of such owned by 

the owner. If the property is land, this is the number of houses on it. 

Rent Current rent on the property. If it is not owned, there is no rent. 

where: where players are: Tells you where all the players are. A '*' indicates the current 
player. 

own holdings: 

List your own holdings, ix. , money, get-out-of-jail-free cards, and property. 

holdings: holdings list: Look at anyone's holdings. It will ask you whose holdings you wish 
to look at. When you are finished, type "done". 

shell: shell escape: Escape to a shell. When the shell dies, the program continues where 

you left off. 

mortgage: mortgage property: Sets up a list of mortgageable property, and asks which you 
wish to mortgage. 

unmortgage: 

unmortgage property: Unmortgage mortgaged property, 

buy: buy houses: Sets up a list of monopolies on which you can buy houses. If there is I 
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more than one, it asks you which you want to buy for. It then asks you how many 
for each piece of property, giving the current amount in parentheses after the pro- 
perty name. If you build in an unbalanced manner (a disparity of more than one 
house within the same monopoly), it asks you to re-input things. 

sell: sell houses: Sets up a Hst of monopolies from which you can sell houses. It 

operates in an analogous manner to buy, 

tSLTd: card for jail: Use a get-out-of -jail-free card to get out of jail. If you're not in jail, or 

you don't have one, it tells you so. 

pay: pay for jail: Pay $50 to get out of jail, from whence you are put on Just Visiting. 

Difficult to do if you're not there. 

trade: This allows you to trade with another player. It asks you whom you wish to trade 
with, and then asks you what each wishes to give up. You can get a summary at 
the end, and, in all cases^ it asks for confirmation of the trade before doing it. 

resign: Resign to another player or the bank. If you resign to the bank, all property 
reverts to its virgin state, and get-out-of-jail free cards revert to the deck. 

save: save game: Save the current game in a file for later play. You can continue play 

after saving, either by adding the file in which you saved the game after the monop 
command, or by using the restore command (see below). It will ask you which file 
you wish to save it in, and, if the file exists, confirm that you wish to overwrite it. 

restore: restore game: Read in a previously saved game from a file. It leaves the file intact. 

roll: Roll the dice and move forward to your new location. If you simply hit the 

<RETURN> key instead of a command, it is the same as typing roll. 



AUTHOR 

Ken Arnold 



FILES 



BUGS 



/usr/games/lib/cards.pck Chance and Community Chest cards 



No command can be given an argument instead of a response to a query. 
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NAME ■ 

number - convert Arabic numerals to English 

SYNOPSIS 

/usr/games/number 

DESCRIPTION 

number copies the standard input to the standard output, changing each decimal number to a 
fully spelled out version. 
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NAME 

quiz ~ test your knowledge 

SYNOPSIS 

/usr/games/qoiz [ — i file ] [ -^t ] [ categoryl category2 ] 

DESCRIPTION 

quiz gives associative knowledge tests on various subjects. It asks items chosen from 
categoryl and expects answers from categoryl. If no categories are specified/ ^i//z gives 
instructions and lists the available categories. 

quiz tells a correct answer whenever you type a bare newline. At the end of input, upon inter- 
rupt, or when questions run out, quiz reports a score and terminates. 

The —t flag specifies ^tutorial' mode, where missed questions are repeated later, and material 
is gradually introduced as you learn. 

The -I flag causes the named file to be substituted for the default index file. The lines of 
these files have the syntax: 

line = category newline [category ':' line 

category = alternate | category 'f alternate 

alternate = empty | alternate primary 

primary = character | *[' category ']' | option 

option = *{' category '}' 

The first category on each line of an index file names an information file. The remaining 
categories specify the order and contents of the data in each line of the information file. 
Information files have the same syntax. Backslash ^V is used as with sh{l) to quote syntacti- 
cally significant characters or to insert transparent newlines into a line. When either a ques- 
tion or its answer is empty, quiz will refrain from asking it. 



FILES 



BUGS 



/usr/games/quiz.k/* 

The construct *a |ab^ doesn't work in an information file. Use *a{b}'. 
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NAME 1^ 

rain - animated raindrops display 

SYNOPSIS 

/usr/games/rain 

DESCRIPTION 

rain 's display is modeled after the VAX/VMS program of the same name. The terminal has 
to be set for 9600 baud to obtain the proper effect. 

As with all programs that use termcap, the TERM environment variable must be set (and 
exported) to the type of the terminal being used. 

FILES 

/etc/termcap 

AUTHOR 

Eric P. Scott 
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NAME 

robots - fight off villainous robots 

SYNOPSIS 

/usr/games/robots [ — sjta ] [ scorefile ] 

DESCRIPTION 

robots pits you against evil robots, who are trying to kill you (which is why they are evil). For- 
tunately for you, even though they are evil, they are not very bright and have a habit of bump- 
ing into each other, thus destroying themselves. In order to survive, you must get them to kill 
each other off, since you have no offensive weaponry. 

Since you are stuck without offensive weaponry, you are endowed with one piece of defensive 
weaponry: a teleportation device. When two robots run into each other or a junk pile, they 
die. If a robot runs into you, you die. When a robot dies, you get 10 points, and when all the 
robots die, you start on the next field. This keeps up until they finally get you. 

robots are represented on the screen by a '+', the junk heaps from their coUisions by a '*', 
and you (the good guy) by a *@'. 

The commands are: 

*h move one square left 

1 move one square right 

k niove one square up 

j move one square down 

y move one square up and left 

u move one square up and right 

b move one square down and left 

n move one square down and right 

(also space) do nothing for one turn 
HJKLBNYU run as far as possible in the given direction 

> do nothing for as long as possible 

t teleport to a random location 

w wait until you die or they all do 

q quit 

"L redraw the screen 

All commands can be preceded by a count. 

If you use the V command and survive to the next level, you will get a bonus of 10% for 
each robot which died after you decided to wait. If you die, however, you get nothing. For 
all other commands, the program will save you from typos by stopping short of being eaten. 
However, with 'w' you take the risk of dying by miscalculation. 

Only five scores are allowed per user on the score file. If you make it into the score file, you 
will be shown the Hst at the end of the game. If an alternate score file is specified, that will be 
used instead of the standard file for scores. 

The options are 

-s Don't play, just show the score file 

-j Jump, /.e. , when you run, don't show any intermediate positions; only show things at 

the end. This is useful on slow terminals. 

-t Teleport automatically when you have no other option. This is a little disconcerting 
until you get used to it, and then it is very nice. 

Advance into the higher levels directly, skipping the lower, easier levels. 
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AUTHOR 

Ken Arnold 



FILES 



BUGS 



/usr/games/lib/robots_roU the score file 



Bugs? You crazy, man?!? 
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NAME 

sail - multi-user wooden ships and iron men 

SYNOPSIS 

sail [ -s [ -1 ] ] [ -x ] [ -b ] [ num ] 

DESCRIPTION 

sail is a computer version of Avalon Hill's game of fighting sail originally developed by S. 
Craig Taylor. 

Players of sail take command of an old fashioned Man of War and fight other players or the 
computer. They may re-enact one of the many historical sea battles recorded in the game, or 
they can choose a fictional battle. 

As a sea captain in the sail Navy, the player has complete control over the workings of his 
ship. He must order every maneuver, change the set of his sails, and judge the right moment 
to let loose the terrible destruction of his broadsides. In addition to fighting the enemy, he 
must harness the powers of the wind and sea to make them work for him. The outcome of 
many battles during the age of sail was decided by the ability of one captain to hold the 
'weather gage.' 

The flags are: 

—s Print the names and ships of the top ten sailors. 

—1 Show the login name. Only effective with -s. 

—X Play the first available ship instead of prompting for a choice. 

— b No bells. 

IMPLEMENTATION 

sail is really two programs in one. Each player starts up a process which runs his own ship. 
In addition, a driver process is forked (by the first player) to run the computer ships and take 
care of global bookkeeping. 

Because the driver must calculate moves for each ship it controls, the more ships the com- 
puter is playing, the slower the game will appear. 

If a player joins a game in progress, he will synchronize with the other players (a rather slow 
process for everyone), and then he may play along with the rest. 

To implement a multi-user game in Version 7 UNIX, which was the operating system sail was 
first written under, the communicating processes must use a common temporary file as a place 
to read and write messages. In addition, a locking mechanism must be provided to ensure 
exclusive access to the shared file. For example, sail uses a temporary file named 
/tmp/#sailsink.21 for scenario 21, and corresponding file names for the other scenarios. To 
provide exclusive access to the temporary file, sail uses a technique stolen from an old game 
called "pubcaves" by Jeff Cohen. Processes do a busy wait in the loop 

for (n = 0; link(sync_file, syncjock) < && n < 30; n++) 

sleep (2); 

until they are able to create a link to a file named •7tmp/#saillock.??". The "??" correspond 
to the scenario number of the game. Since UNIX guarantees that a link will point to only one 
file, the process that succeeds in linking will have exclusive access to the temporary file. 

Whether or not this really works is open to speculation. When ucbmiro was rebooted after a 
crash, the file system check program found 3 links between the sail temporary file and its link 
file. 
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CONSEQUENCES OF SEPARATE PLAYER AND DRIVER 

When players do something of global interest, such as moving or Mng, the driver must coor- 
dinate the action with the other ships in the game. For example, if a player wants to move in 
a certain direction, he writes a message into the temporary file requesting the driver to move 
his ship. Each ''turn,'' the driver reads all the messages sent from the players and decides 
what happened. It then writes back into the temporary file new values of variables, etc. 

The most noticeable effect this communication has on the game is the delay in moving. Sup- 
pose a player types a -move for his ship and hits return. What happens then? The player pro- 
cess saves up messages to be written to the temporary file in a buffer. Every 7 seconds or so, 
the player process gets exclusive access to the temporary file and writes out its buffer to the 
file. The driver, running asynchronously, must read in the movement command, process it, 
and write out the results. This takes two exclusive accesses to the temporary file. Finally, 
when the player process gets around to doing another 7 second update, the results of the 
move are displayed on the screen. Hence, every movement requires four exclusive accesses to 
the temporary file (anywhere from 7 to 21 seconds depending upon asynchrony) before the 
player sees the results of his moves. 

In practice, the delays are not as annoying as they would appear. There is room for "pipelin- 
ing" in the movement. After the player writes out a first movement message, a second move- 
ment command can then be issued. The first message will be in the temporary file waiting for 
the driver, and the second will be in the file buffer waiting to be written to the file. Thus, by 
always typing moves a turn ahead of the time, the player can sail around quite quickly. 

If the player types several movement commands between two 7 second updates, only the last 
movement command typed will be seen by the driver. Movement commands within the same 
update "overwrite" each other, in a sense. 

THE HISTORY OF SAIL 

I wrote the first version of sail on a PDF 11/70 in the fall of 1980. Needless to say, the code 
was horrendous, not portable in any sense of the word, and didn^t work. The program was 
not very modular and had fseeksQ and fwrites() every few lines. After a tremendous rewrite 
from the top down, I got the first working version up by 1981. There were several anhoying 
bugs concerning firing broadsides and finding angles, sail uses no floating point, by the way, 
so the direction routines are rather tricky. Ed Wang rewrote my angle() routine in 1981 to be 
more correct (although it still doesn't work perfectly), and he added code to let a player select 
which ship he wanted at the start of the game (instead of the first one available). 

Captain Happy (Craig Teres) is responsible for making sail portable for the first time. This 
was no easy task, by the way. Constants like 2 and 10 were very frequent in the code. I also 
became famous for using "Riggle Memorial Structures" in sail Many of my structure refer- 
ences are so long that they run off the line printer page. Here is an example, if you promise 
not to laugh. 

specs[scene[flog.fgamenum].ship[flog.fshipnum].shipnum].pts 

sail received its fourth and most thorough rewrite in the summer and fall of 1983. Ed Wang 
rewrote and modularized the code (a monumental feat) almost from scratch. Although he 
introduced many new bugs, the final result was very much cleaner and (?) faster. He added 
window movement commands and find ship commands. 

HISTORICAL INFO 

Old Square Riggers were very maneuverable ships capable of intricate sailing. Their only 
disadvantage was an inability to sail very close to the wind. The design of a wooden ship 
allowed only for the guns to bear to the left and right sides. A few guns of small aspect (usu- 
ally 6 or 9 pounders) could point forward, but their effect was small compared to a 68 gun 
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broadside of 24 or 32 pounders. The guns bear approximately like so: 

\ 
b-^-.^ 

-0 
\ 
\ 

\ up to a range of ten (for round shot) 
\ 
\ 
\ 

An interesting phenomenon occurred when a broadside was fired down the length of an 
enemy ship. The shot tended to bounce along the deck and did several times more damage. 
This phenomenon was called a rake. Because the bows of a ship are very strong and present a 
smaller target than the stern, a stem rake (firing from the stern to the bow) causes more dam- 
age than a bow rake. 

b 

00 — Stem rake! 
a 

Most ships were equipped with carronades, which were very large, close range cannons, 
American ships from the revolution until the War of 1812 were almost entirely armed with car- 
ronades. 

The period of history covered in sail is approximately from the 1770's until the end of Napole- 
anic France in 1815. There are many excellent books about the age of sail. My favorite 
author is Captain Frederick Marryat. More contemporary authors include C.S. Forester and 
Alexander Kent. 

Fighting ships came in several sizes classed by armament. The mainstays of any fleet were its 
"Ships of the Line", or "Line of Battle Ships". They were so named because these ships 
fought together in great lines. They were close enough for mutual support, yet every ship 
could fire both its broadsides. We get the modem words "ocean liner," or "liner," and "battle- 
ship" from "ship of the Une." The most common size was the the 74 gun two decked ship of 
the line. The two gun decks usually mounted 18 and 24 pounder guns. 

The pride of the fleet were the first rates. These were huge three decked ships of the line 
mounting 80 to 136 guns. The guns in the three tiers were usually 18, 24, and 32 pounders in 
that order from top to bottom. 

Various other ships came next. They were almost all "razees," or ships of the line with one 
deck sawed off. They mounted 40-64 guns and were a poor cross between a frigate and a line 
of battle ship. They neither had the speed of the former nor the firepower of the latter. 

Next came the "eyes of the fleet." Frigates came in many sizes mounting anywhere from 32 to 
44 guns. They were very handy vessels. They could outsail anything bigger and outshoot any- 
thing smaller. Frigates didn't fight in lines of battle as the much bigger 74's did. Instead, they 
harassed the enemy's rear or captured crippled ships. They were much more useful in mis- 
sions away from the fleet, such as cutting out expeditions or boat actions. They could hit hard 
and get away fast. 

Lastly, there were th^ corvettes, sloops, and brigs. These were smaller ships mounting typi- 
cally fewer than 20 guns. A corvette was only slightly smaller than a frigate, so one might 
have up to 30 guns. Sloops were used for carrying dispatches or passengers. Brigs were 
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something you built for land-locked lakes. \ 

SAIL PARTICULARS 

Ships in sail are represented by two characters. One character represents the bow of the ship, 
and the other represents the stem. Ships have nationaUties and numbers. The first ship of a 
nationality is number 0, the second number 1, etc. Therefore, the first British ship in a game 
would be printed as "bO". The second Brit would be "bl", and the fifth Don would be "s4". 

Ships can set normal sails, called Battle sails^ or bend on extra canvaS; called Full sails. A 
ship under full sail is a beautiful sight indeed, and it can move much faster than a ship under 
Battle sails. The only trouble is, with full sails set, there is so much tension on sail and rigging 
that a well aimed round shot can burst a sail into ribbons where it would only cause a little 
hole in a loose sail. For this reason, rigging damage is doubled on a ship with full sails set. 
Don^t let that discourage you from using full sails. I like to keep them up right into the heat 
of battle. A ship with full sails set has a capital letter for its nationality. E.g., a Frog, "fO", 
with full sails set would be printed as "FO". 

When a ship is battered into a Usting hulk, the last man aboard "strikes the colors." This 
ceremony is the ship's formal surrender. The nationality character of a surrendered ship is 
printed as "!". E.g., the Frog of our last example would soon be "!0". 

A ship has a random chance of catching fire or sinking when it reaches the stage of Usting 
hulk. A sinking ship has a "'^" printed for its, nationality, and a ship on fire and about to 
explode has a "#" printed. 

Captured ships become the nationality of the prize crew. Therefore, if an American ship cap- 
tures a British ship, the British ship will have an "a" printed for its nationality. In addition, 
the ship number is changed to "&","'", "(", ,")", "*", or "4-" depending upon the original ^ 

number, be it 0,1,2,3,4, or 5. E.g., the "bO" captured by an American becomes the "a&". I 

The "s4" captured by a Frog becomes the "f*". ^ 

The ultimate example is, of course, an exploding Brit captured by an American: "#&". 
MOVEMENT 

Movement is the most confusing part of sail to many. Ships can head in 8 directions: 

















b 


b 


bO 


b 


b b 


Ob 


















The stem of a ship moves when it turns. The bow remains stationary. Ships can always turn, 
regardless of the wind (unless they are becalmed). All ships drift when they lose headway. If 
a ship doesn't move forward at all for two turns, it will begin to drift. If a ship has begun to 
drift, then it must move forward before it turns, if it plans to do more than make a right or 
left turn, which is always possible. 

Movement commands to sail are a string of forward moves and turns. An example is "13". It 
will turn a ship left and then move it ahead 3 spaces. In the drawing above, the "bO" made 7 
successive left turns. When sail prompts you for a move, it prints three characters of import. 
E.g., 

move (7, 4): 
The first number is the maximum number of moves you can make, including turns. The 
second number is the maximum number of turns you can make. Between the nunibers is 
sometimes printed a quote "'". If the quote is present, it means that your ship has been drift- 
ing, and you must move ahead to regain headway before you turn (see note above). Some of 
the possibly moves for the example above are as follows: 
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move (7, 4): 7 

move (7, 4): 1 

move (7, 4): d /* drift, or do nothing */ 

move (7, 4): 6r 

move (7, 4): 5x1 

move (7, 4): 4rlr 

move (7, 4): llrlr2 

move (7, 4): Irlrlrl 

Because square riggers performed so poorly sailing into the wind, if at any point in a move- 
ment command you turn into the wind, the movement stops there. E.g., 

move (7, 4): 1114 
Movement Error; 
Helm: HI 

Moreover, whenever yoii make a turn, your movement allowance drops to min(what's left, 
what you would have at the new attitude). In short, if you turn closer to the wind, you most 
likely won't be able to sail the full allowance printed in the "move" prompt. 

Old sailing captains, had to keep an eye constantly on the wind. Captains in sail axe no 
different. A ship's ability to move depends on its attitide to the wind. The best angle possi- 
ble is to have the wind off your quarter, that is, just off the stem. The direction rose on the 
side of the screen gives the possible movements for your ship at all positions to the wind. 
Battle sail speeds are given first, and full sail speeds are given in parenthesis, 

01(2) 

\\/ 
--^-3(6) 

/^ 

1 4(7) 
3(6) 

Pretend the bow of your ship (the """) is pointing upward and the wind is blowing from the 
bottom to the top of the page. The numbers at the bottom "3(6)" will be your speed under 
battle or full sails in such a situation. If the wind is off your quarter, then you can move 
"4(7)". If the wind is off your beam, "3(6)". If the wind is off your bow, then you can only 
move "1(2)". Facing into the wind, you can't move at all. Ships facing into the wind were 
said to be "in irons". 

WINDSPEED AND DIRECTION 

The windspeed and direction is displayed as a little weather vane on the side of the screen. 
The number in the middle of the vane indicates the wind speed, and the + to - indicates the 
wind direction. The wind blows from the + sign (high pressure) to the - sign (low pressure). 
E.g., 

I 
3 

+ 

The wind speeds are = becalmed, 1 == light breeze, 2 = moderate breeze, 3 ^ fresh breeze, 4 
=^ strong breeze, 5 == gale, 6 = full gale, 7 = hurricane. If a hurricane shows up, all ships are 
destroyed. 
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GRAPPLING AND FOULING 

If two ships collide, they run th^ ri^k of becommg tangled together. This is cdled "fowliBg," 
Fouled ships are stuck together, and tieither mn ipove. They can unfoul each other i| they 
want to. Boarding parties can only ba sent across to ships when the antagonists are either 
fouled or grappled. 

Ships can grapple each other by throwing grapnels into the rigging of the other. 

The number of fouls and grapples you have are disiplayed on the upper right of the screen, 

BOARDING 

Boarding was a very costly venture in terms of human life. Boarding parties may be fornaed in 
sail to either board an enemy ship or to defend your own ship against attack/ Men organteed 
as Defensive Boarding Parties fight twice as hard to save their ship as mm left unorgaiiized, 

The boarding strength of a crew depends upon its quality and upon the number of mm mnt 

CREW QUALITY 

The British seaman was world renowned for his sailing abilities. American sailors, however, 
were actually the best seamen in the world. Because the American Navy offered twice the 
wages of the Royal Navy, British seamen who liked the sea defected to America by the 
thousands. 

In sail, crew quality is quantised into 5 energy levels, 'Blite" crews can outshopt and outight 
all other sailors, "Crack" crews are nej^t. "Mundane" crews are average, and "Crreen" and 
"Mutinous" crews are below average. A good rule of thumb is that "Crack" or "EUte" crews 
get one extra hit per broadside comparecl to "Mundane" crews. Don't expect too much from 
"Green" crews. . 

BROADSIDES 

Your two broadsides may be loaded with four kinds of shot: grape, chain, round, and double. 
You have guns and carronades in both the port and starboard batteries, Carronades only have 
a range of two, so you have to get in close to be able to fire them. You have the choice of 
firing at the hull or rigging of another ship. If the range of the ship is greater than 6, then you 
may only shoot at the rigging. 

The types of shot and their advantages are: 

ROUND ■ 

Range of 10, Good for hull or rigging hits, 
DOUBLE 

Range of 1. Extra good for hull or rigging hits; Double takes two turns to load, 

CHAIN 

Range of 3. Excellent for tearing down rigging, Cannot damage hull or guns, though. 

GRAPE 

Range of 1. Sometimes devastating against enemy erews. 

On the side of the screen is displayed some vital information about your ship: 

Load D!R! 
Hull 9 

Crew 4 4 2 
Ouns 4 4 
Carr 2 2 
Rigg 55 5 5 

"Load" shows what your port (left) and starboard (right) broadsides are loaded with, A "!*' 
after the type of shot indicates that it is an initiaLbroadside. Initial broadside were loaded 
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with care before battle and before the decks ran red with blood. As a consequence, initial 
broadsides are a little more effective than broadsides loaded later. A "*" after the type of shot 
indicates that the gun crews are still loading it, and you cannot fire yet. "Hull" shows how 
much hull you have left. "Crew" shows your three sections of crew. As your crew dies off, 
your ability to fire decreases. "Guns" and "Carr" show your port and starboard guns. As you 
lose guns, your ability to fire decreases. "Rigg" shows how much rigging you have on your 3 or 
4 masts. As rigging is shot away, you lose mobility. 

EFFECTIVENESS OF FIRE 

It is very dramatic when a ship fires its thunderous broadsides, but the mere opportunity to 
fire them does not guarantee any hits. Many factors influence the destructive force of a broad- 
side. First of all, and the chief factor, is distance. It is harder to hit a ship at range ten than 
it is to hit one sloshing alongside. Next is raking. Raking fire, as mentioned before, can 
sometimes dismast a ship at range ten. Next, crew size and quaUty affects the damage done by 
a broadside. The number of guns firing also bears on the point, so to speak. Lastly, weather 
affects the accuracy of a broadside. If the seas are high (5 or 6), then the lower gunports of 
ships of the line can't even be opened to run out the guns. This gives frigates and other flush 
decked vessels an advantage in a storm. The scenario Pellew vs. The Droits de L'Homme 
takes advantage of this pecuUar circumstance. 

REPAIRS 

Repairs may be made to your Hull, Guns, and Rigging at the slow rate of two points per three 
turns. The message "Repairs Completed" will be printed if no more repairs can be made. 

PECULIARITIES OF COMPUTER SHIPS 

Computer ships in sail follow all the rules above with a few exceptions. Computer ships never 
repair damage. If they did, the players could never beat them. They play well enough as it is. 
As a consolation, the computer ships can fire double shot every turn. That fluke is a good 
reason to keep your distance. The Driver figures out the moves of the computer ships. It 
computes them with a typical A.I. distance function and a depth first search to find the max- 
imum "score." It seems to work fairly well, although Til be the first to admit it isn't perfect. 

HOW TO PLAY 

Commands are given to sail by typing a single character. You will then be prompted for 
further input. A brief summary of the commands follows. 
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COMMAND SUMMARY ^ 

'f Fire broadsides if they bear 
r Reload 

X' Unload broadsides (to change ammo) 
'm' Move 

'i' Print the closest ship 
T Print all ships 

'P Find a particular ship or ships (e,g. "a?" for all Americans) 
's' Send a message around the fleet 
'b' Attempt to board an enemy ship 
'B' Recall boarding parties 
'c' Change set of sail 

V Repair 

'u' Attempt to unfoul 
'g' Grapple/ungrapple 

V Print version number of game 
'""L' Redraw screen 

'Q' Quit 

'C Center your ship in the window 

'U' Move window up 

'DVN^ Move window down 

'H' Move window left 

'J' Move window right 

'S' Toggle window to follow your ship or stay where it is ^ 

SCENARIOS 

Here is a summary of the scenarios in ^-ai/; 

Ranger vs. Drake: 

Wind from the N, blowing a fresh breeze. 

(a) Ranger 19 gun Sloop (crack crew) (7 pts) 

(b) Drake 17 gun Sloop (crack crew) (6 pts) 
The Battle of Flamborough Head; 

Wind from the S, blowing a fresh breeze. 

This is John Paul Jones' first famous battle. Aboard the Bonhomme Richard, he was able to 
overcome the Serapis's greater firepower by quickly boarding her. 

(a) Bonhomme Rich 42 gun Corvette (crack crew) (11 pts) 

(b) Serapis 44 gun Frigate (crack crew) (12 pts) 

Arbuthnot and Des Touches; 

Wind from the N, blowing a gale. 

(b) America 64 gun Ship of the Line (crack crew) (20 pts) 

(b) Befford 74 gun Ship of the Line (crack crew) (26 pts) 

(b) Adamant 50 gun Ship of the Line (crack crew) (17 pts) 

(b) London 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Royal Oak 74 gun Ship of the Line (crack crew) (26 pts) i 

(f) Neptune 74 gun Ship of the Line (average crew) (24 pts) ^ 
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(f) Due Bougogne 80 gun 3 Decker SOL (average crew) (27 pts) 

(f) Conquerant 74 gun Ship of the Line (average crew) (24 pts) 

(f) Provence 64 gun Ship of the Line (average crew) (18 pts) 

(f) Romulus 44 gun Ship of the Line (average crew) (10 pts) 

Suffren and Hughes: 

Wind from the S, blowing a fresh breeze. 



(b) Monmouth 
(b) Hero 
(b) Isis 
(b) Superb 
(b) Burf ord 
(f) Flamband 
(f) Annibal 
(f) Severe 
(f) Brilliant 
(f) Sphinx 



74 gun Ship of the Line (average crew) (24 pts) 
74 gun Ship of the Line (crack crew) (26 pts) 
50 gun Ship of the Line (crack crew) (17 pts) 
74 gun Ship of the Line (crack crew) (27 pts) 
74 gun Ship of the Line (average crew) (24 pts) 
50 gun Ship of the Line (average crew) (14 pts) 
74 gun Ship of the Line (average crew) (24 pts) 
64 gun Ship of the Line (average crew) (18 pts) 
80 gun Ship of the Line (crack crew) (31 pts) 
80 gun Ship of the Line (average crew) (27 pts) 



Nymphe vs. Cleopatre: 

Wind from the S, blowing a fresh breeze. 

(b) Nymphe 36 gun Frigate (crack crew) (11 pts) 

(f) Cleopatre 36 gun Frigate (average crew) (10 pts) 

Mars vs. Hercule: 

Wind from the S, blowing a fresh breeze. 

(b) Mars 74 gun Ship of the Line (crack crew) (26 pts) 

(f) Hercule 74 gun Ship of the Line (average crew) (23 pts) 

Ambuscade ys^ Baionnaise: 

Wind from the N, blowing a fresh breeze. 



(b) Ambuscade 
(f) Baionnaise 



32 gun Frigate (average crew) (9 pts) 
24 gun Corvette (average crew) (9 pts) 



Constellation vs. Insurgent: 

Wind from the S, blowing a gale. 



(a) Constellation 
(f) Insurgent 



38 gun Corvette (elite crew) (17 pts) 
36 gun Corvette (average crew) (11 pts) 



Constellation vs. Vengeance: 

Wind from the S, blowing a fresh breeze. 



(a) Constellation 
(f) Vengeance 



38 gun Corvette (elite crew) (17 pts) 
40 gun Frigate (average crew) (15 pts) 



The Battle of Lissa: 

Wind from the S, blowing a fresh breeze. 

(b) Amphion 32 gun Frigate (elite crew) (13 pts) 

(b) Active 38 gun Frigate (elite crew) (18 pts) 

(b) Volage 22 gun Frigate (eUte crew) (11 pts) 

(b) Cerberus 32 gun Frigate (elite crew) (13 pts) 

(f) Favorite 40 gun Frigate (average crew) (15 pts) 

(f) Flore 40 gun Frigate (average crew) (15 pts) 
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(f) Danae 40 gun Frigate (crack crew) (17 pts) 

(f) Bellona 32 gun Frigate (green crew) (9 pts) 

(f) Corona 40 gun Frigate (green crew) (12 pts) 

(f) Carolina 32 gun Frigate (green crew) (7 pts) 

Constitution vs. Guerriere: 

Wind from the SW, blowing a gale. 

(a) Constitution 44 gun Corvette (elite crew) (24 pts) 

(b) Guerriere 38 gun Frigate (crack crew) (15 pts) 

United States vs. Macedonian: 

Wind from the S, blowing a fresh breeze. 

(a) United States 44 gun Frigate (elite crew) (24 pts) 

(b) Macedonian 38 gun Frigate (crack crew) (16 pts) 

Constitution vs. Java: 

Wind from the S, blowing a fresh breeze. 

(a) Constitution 44 gun Corvette (elite grew) (24 pts) 

(b) Java 38 gun Corvette (crack crew) (19 pts) 

Chesapeake vs. Shannon: 

Wind from the S, blowing a fresh breeze. 

(a) Chesapeake 38 gun Frigate (average crew) (14 pts) 

(b) Shannon 38 gun Frigate (elite crew) (17 pts) 

The Battle of Lake Erie: 

Wind from the S, blowing a light breeze. 

(a) Lawrence 20 gun Sloop (crack crew) (9 pts) 

(a) Niagara 20 gun Sloop (elite crew) (12 pts) 

(b) Lady Prevost 13 gun Brig (crack crew) (5 pts) 
(b) Detroit 19 gun Sloop (crack crew) (7 pts) 
(b) Q. Charlotte 17 gun Sloop (crack crew) (6 pts) 

Wasp vs. Reindeer: 

Wind from the S, blowing a light breeze. 

(a) Wasp 20 gun Sloop (elite crew) (12 pts) 

(b) Reindeer 18 gun Sloop (elite crew) (9 pts) 

Constitution vs. Cyane and Levant: 

Wind from the S, blowing a moderate breeze. 

(a) Constitution 44 gun Corvette (elite crew) (24 pts) (b) Cyane 24 gun Sloop 
(crack crew) (11 pts) (b) Levant 20 gun Sloop (crack crew) (10 pts) 

Pellew vs. Droits de L'Homme: 

Wind from the N, blowing a gale. 

(b) Indefatigable 44 gun Frigate (elite crew) (14 pts) 
(b) Amazon 36 gun Frigate (crack crew) (14 pts) 

(f) Droits L'Hom 74 gun Ship of the Line (average crew) (24 pts) ^ 

i 
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Algeciras: 

Wind from the SW, blowing a moderate breeze. 

(b) Caesar 80 gun Ship of the Line (crack crew) (31 pts) 

(b) Pompee 74 gun Ship of the Line (crack crew) (27 pts) 

(b) Spencer 74 gun Ship of the Line (crack crew) (26 pts) 

(b) Hannibal 98 gun 3 Decker SOL (crack crew) (28 pts) 

(s) Real-Carlos 112 gun 3 Decker SOL (green crew) (27 pts) 

(s) San Fernando 96 gun 3 Decker SOL (green crew) (24 pts) 

(s) Argonauta 80 gun Ship of the Line (green crew) (23 pts) 

(s) San Augustine 74 gun Ship of the Line (green crew) (20 pts) 

(f) Indomptable 80 gun Ship of the Line (average crew) (27 pts) 

(f) Desaix 74 gun Ship of the Line (average crew) (24 pts) 

Lake Champlain: 

Wind from the N, blowing a fresh breeze. 

(a) Saratoga 26 gun Sloop (crack crew) (12 pts) 

(a) Eagle 20 gun Sloop (crack crew) (11 pts) 
(a) Ticonderoga 17 gun Sloop (crack crew) (9 pts) 

(a) Preble 7 gun Brig (crack crew) (4 pts) 

(b) Confiance 37 gun Frigate (crack crew) (14 pts) 
(b) Linnet 16 gun Sloop (elite crew) (10 pts) 
(b) Chubb 11 gun Brig (crack crew) (5 pts) 

Last Voyage of the USS President: 

Wind from the N, blowing a fresh breeze. 

(a) President 44 gun Frigate (elite crew) (24 pts) 

(b) Endymion 40 gun Frigate (crack crew) (17 pts) 
(b) Pomone 44 gun Frigate (crack crew) (20 pts) 
(b) Tenedos 38 gun Frigate (crack crew) (15 pts) 

Homblower and the Natividad: 

Wind from the E, blowing a gale. 

A scenario for you Homy fans. Remember, he sank the Natividad against heavy odds and 
winds. Hint: don't try to board the Natividad, her crew is much bigger, albeit green. 

(b) Lydia 36 gun Frigate (elite crew) (13 pts) 

(s) Natividad 50 gun Ship of the Line (green crew) (14 pts) 

Curse of the Flymg Dutchman: 

Wind from the S, blowing a fresh breeze. 

Just for fun, take the Piece of cake. 

(s) Piece of Cake 24 gun Corvette (average crew) (9 pts) 

(f) Flying Dutchy 120 gun 3 Decker SOL (eUte crew) (43 pts) 

The South Pacific: 

Wind from the S, blowing a strong breeze. 

(a) USS Scurvy 136 gun 3 Decker SOL (mutinous crew) (27 pts) 

(b) HMS Tahiti 120 gun 3 Decker SOL (elite crew) (43 pts) 
(s) Australian 32 gun Frigate (average crew) (9 pts) 
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(f) Bikini Atoll 7 gun Brig (crack crew) (4 pts) 

Hornblower and the battle of Rosas 

Wind from the E, blowing a fresh breeze. 

The only battle Hornblower ever lost. He was able to dismast one 
ship and stern rake the others though. See if you can do as well. 

(b) Sutherland 74 gun Ship of the Line (crack crew) (26 pts) 

(f) Turenne 80 gun 3 Decker SOL (average crew) (27 pts) 

(f) Nightmare 74 gun Ship of the Line (average crew) (24 pts) 

(f ) Paris 112 gun 3 Decker SOL (green crew) (27 pts) 

(f) Napolean 74 gun Ship of the Line (green crew) (20 pts) 
Cape Horn: 

Wind from the NE, blowing a strong breeze. 

(a) Concord 80 gun Ship of the Line (average crew) (27 pts) 

(a) Berkeley 98 gun 3 Decker SOL (crack crew) (28 pts) 

(b) Thames 120 gun 3 Decker SOL (elite crew) (43 pts) 
(s) Madrid 112 gun 3 Decker SOL (green crew) (27 pts) 
(f) Musket 80 gun 3 Decker SOL (average crew) (27 pts) 

New Orleans J 

Wind from the SE, blowing a fresh breeze. 

Watch that little Cypress go! 

(a) Alligator 120 gun 3 Decker SOL (elite crew) (43 pts) 

(b) Firefly 74 gun Ship of the Line (crack crew) (27 pts) 
(b) Cypress 44 gun Frigate (elite crew) (14 pts) 

Botany Bay: 

Wind from the N, blowing a fresh breeze. 

(b) Shark 64 gun Ship of the Line (average crew) (18 pts) 

(f) Coral Snake 44 gun Corvette (eUte crew) (24 pts) 
(f) Sea Lion 44 gun Frigate (elite crew) (24 pts) 

Voyage to the Bottom of the 

Wind from the NW, blowing a fresh breeze. 

This one is dedicated to Richard Basehart and David Hedison. 

(a) Seaview 120 gun 3 Decker SOL (elite crew) (43 pts) 

(a) Flying Sub 40 gun Frigate (crack crew) (17 pts) 

(b) Mermaid 136 gun 3 Decker SOL (mutinous crew) (27 pts) 
(s) Giant Squid 112 gun 3 Decker SOL (green crew) (27 pts) 

Frigate Actions 

Wind from the E, blowing a fresh breeze. 

(a) Killdeer 40 gun Frigate (average crew) (15 pts) 

(b) Sandpiper 40 gun Frigate (average crew) (15 pts) 
(s) Curiew 38 gun Frigate (crack crew) (16 pts) 
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The Battle of Midway: 

Wind from the E, blowing a moderate breeze. 

(a) Enterprise 80 gun Ship of the Line (crack crew) (31 pts) 
(a) Yorktown 80 gun Ship of the Line (average crew) (27 pts) 

(a) Hornet 74 gun Ship of the Line (average crew) (24 pts) 

(j) Akagi 112 gun 3 Decker SOL (green crew) (27 pts) 

(j) Kaga 96 gun 3 Decker SOL (green crew) (24 pts) 

(j) Soryu 80 gun Ship of the Line (green crew) (23 pts) 

Star Trek: 

Wind from the S, blowing a fresh breeze. 

(a) Enterprise 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Yorktown 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Reliant 450 gun Ship of the Line (elite crew) (75 pts) 

(a) Galileo 450 gun Ship of the Line (elite crew) (75 pts) 
(k) Kobayashi Maru 450 gun Ship of the Line (elite crew) (75 pts) 

(k) Klingon II 450 gun Ship of the Line (ehte crew) (75 pts) 

(o) Red Orion 450 gun Ship of the Line (elite crew) (75 pts) 

(o) Blue Orion 450 gun Ship of the Line (ehte crew) (75 pts) 

CONCLUSION 

sail has been a group effort. 

Ken Arnold Code 

curses library (pu!) 

AUTHOR 

Dave Riggle 

CO-AUTHOR 

Ed Wang 
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Craig Leres 
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Chris Guthrie 
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Frank Mildmay, or The Naval Officer 

SEE ALSO 

midway(PUBLIC) 

BUGS 

Probably a few, and please report th^m to "ri|gle@ernie" and "edward@arpa." 
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NAME 

snake, snscore - display chase game 

SYNOPSIS 

/usr/games/snake [ — wn ] [ —In ] 
/usr/games/snscore 

DESCRIPTION 

Snake is a display-based game which must be played on a CRT terminal from among those 
supported by vi(l). The object of the game is to make as much money as possible without 
getting eaten by the snake. The —1 and — w options allow you to specify the length and width 
of the field. By default the entire screen (except for the last column) is used. 

You are represented on the screen by an I. The snake is 6 squares long and is represented by 
S's. The money is $, and an exit is #. Your score is posted in the upper left hand corner. 

You can move around using the same conventions as vi(l), the h, j, k, and 1 keys work, as do 
the arrow keys. Other possibilities include: 

sefc These keys are like hjkl but form a directed pad around the d key. 

HJKL These keys move you all the way in the indicated direction to the same row or column 
as the money. This does not let you jump away from the snake, but rather saves you 
from having to type a key repeatedly. The snake still gets all his turns. 

SEFC Likewise for the upper case versions on the left. 

ATPB These keys move you to the four edges of the screen, Their position on the keyboard 
is the mnemonic, e.g. P is at the far right of the keyboard. 

X This lets you quit the game at any time. 

p Points in a direction you might want to go. 

w Space warp to get out of tight squeezes, at a price. 

! Shell escape 

Z Suspend the snake game, on systems which support it. Otherwise an interactive shell 

is started up. 

To earn money, move to the same square the money is on. A new $ will appear when you 
earn the current one. As you get richer, the snake gets hungrier. To leave the game, move to 
the exit (#). 

A record is kept of the personal best score of each player. Scores are only counted if you 
leave at the exit, getting eaten by the snake is worth nothing. 

As in pinball, matching the last digit of your score to the number which appears after the 
game is worth a bonus. 

To see who wastes time playing snake, run /usr/games/snscore . 



FILES 



BUGS 



/usr/games/lib/snakerawscores database of personal bests 

/usr/games/lib/snake.log log of games played 

/usr/games/busy program to determine if system too busy 

When playing on a small screen, it's hard to tell when you hit the edge of the screen. 

The scoring function takes into account the size of the screen. A perfect function to do this 
equitably has not been devised. 
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NAME \ 

trek ~ trekkie game 

SYNOPSIS 

/usr/games/trek [ [ --a ] file ] 

DESCRIPTION 

trek is a game of space glory and war. Below is a summary of commands. For complete 
documentation, see /reA: by Eric Allman. 

If a filename is given, a log of the game is written onto that file. If the -a flag is given before 
the filename, that file is appended to, not truncated. 

The game will ask you what length game you would like. VaUd responses are '* short", 
"medium'', and "long''. You may also type "restart", which restarts a previously saved game. 
You will then be prompted for the skill, to which you must respond "novice", /^f air", "good", 
"expert", "commadore", or "impossible". You should normally start out with a novice and 
work up. 

In general, throughout the game, if you forget what is appropriate the game will tell you what 
it expects if you just type in a question mark. 

AUTHOR 

Eric Allman 

SEE ALSO 

/usr/doc/trek 

COMMAND SUMMARY 

abandon capture ^ 

cloak up/down f 

computer request; ... damages ^ 

destruct dock 

h^ip impulse course distance 

Irscan move course distance 

phasers automatic amount 

phasers manual amtl coursel spreadl ... 

torpedo course [yes] angle/no 

ram course distance rest time 

shell shields up/down 

srscan [yes/no] 

status terminate yes/no 

undock visual course 

warp warp_f actor 
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W0RM(6-BSD) RISC/os Programmer's Reference WORM(6^BSD) 



NAME 

worm - Play the growing worm game 

SYNOPSIS 

/usr/games/worm [ size ] 

DESCRIPTION 

In worm, you are a little worm, your body is the "o"'s on the screen and your head is the *'@". 
You move with the hjkl keys (as in the game snake). If you don't press any keys, you con- 
tinue in the direction you last moved. The upper case HJKL keys move you as if you had 
pressed several (9 for HL and 5 for JK) of the corresponding lower case key (unless you run 
into a digit, then it stops). 

On the screen you will see a digit, if your worm eats the digit is will grow longer, the actual 
amount longer depends on which digit it was that you ate. The object of the game is to see 
how long you can make the worm grow. 

The game ends when the worm runs into either the sides of the screen, or itself. The current 
score (how much the worm has grown) is kept in the upper left corner of the screen. 

The optional argument, if present, is the initial length of the worm. 



BUGS 



If the initial length of the worm is set to less than one or more than 75, various strange things 
happen. 
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WORMS ( 6^BSD ) RISC/os Programmer's Reference WORMS ( ^^BSP ) 



NAME' 

worms - animate worms on a display terminal 

SYNOPSIS 

/usr/games/worms [ '-afield ] [ -^length # ] [ *^wunnber # ] [ —trail ] 

DESCRIPTION 

Brian Horn (qitheplbdli) showed me a TOPS'-20 program on the DEC-2136 machine called 
WOJiM, and suggested that I write a similar program that would run under Unix. I did, and 
no apologies. 

-afield malces a "field" for the worm(s) to eat; ■^trail causes each worm to leave a trail behind 
it, You can figure out the rest by yourself. 

FII.ES- ■ 

/etc/termeap 

AUTHOR 

Eric P. Scott 

SEE ALSO 

5na^"fa, by Karl Heuer 

BUGS 

The Ipwer-right-hand character position will not be updated properly on a terminal that wraps 
at the right margin. 

Terminal initiaH;?;ation is not performed. 
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WUMP ( 6-BSD ) RISC/os Programmer's Reference WUMP ( 6-BSD ) 



NAME 

wump - the game of hunt-the-wumpus 

SYNOPSIS 

/u sr/gani^e s/wump 

DESCRIPTION 

wump plays the game of *Hunt the wumpus/ A wumpus is a creature that hves in a cave with 
several rooms connected by tuniiels. You wander among the rooms, trying to shoot the 
wumpus with an arrow, meanwhile avoiding being eaten by the wumpus and falling into Bot- 
tomless Pits. There are also Super Bats which are likely to pick you up and drop you in some 
random room. 

The program asks various questions which you answer one per Une; it will give a more detailed 
description if you want. 

This program is based on one described in People's Computer Company, 2, 2 (November 
1973). 
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Z0RK(6^BSD) RISC/os Programmer's Reference ZORK(6-BSD) 



NAME 

zork - the game of dungeon 

SYNOPSIS 

/u sr/games/zork 

PESCRIPTJON 

Dungeon is a computer fantasy simulation based on Adventure and on Dungeons & Dragons, 
originally written by Lebling, Blank, and Anderson of MIT. In it you explore a dungeon 
made up of various rooms, caves, rivers, and so on. The object of the game is to collect as 
much treasure as possible and stow it safely in the trophy case (and, of course, to stay alive.) 

Figuring out the rules is part of the game, but if you are stuck, you should start off with "open 
mailbox", "take leaiOiet'', and then *Vead leaflet". Additional useful commands that are not 
documented include: 

quit (to end the game) 

!cmd (the usual shell escape convention) 

> (to save a game) 

< (to restore a game) 

FILES 

/usr/games/lib/d* 
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